It is obvious that the grey of the blocks and the grey in the horizontal rule don't match up with the rest of the page.

Adding a small amount of the color from the background to it could greatly improve the look.

An image of my first question

share

3 Answers 3

Please ‘never’ use 𝚖𝚘𝚗𝚘𝚜𝚙𝚊𝚌𝚎𝚍 𝚝𝚎𝚡𝚝 on ELU


tl;dr

  1. Please don’t use ˋbackticksˋ at all: use italics instead.
  2. Please don’t use preformatted indented blocks except for tables.
  3. Nonetheless, you were right about one aspect of the trouble: the color.

Thank you for pointing that out. While you have indeed identified a genuine problem, I am afraid that you have slightly misdiagnosed it.

The main problem isn’t so much that color of the monospaced stuff is off — although you’re quite right that it is. Rather, the greater problem is that one should never be using that 𝚞𝚐𝚕𝚢 𝚖𝚘𝚗𝚘𝚜𝚙𝚊𝚌𝚎𝚍𝚏𝚘𝚗𝚝 at all on ELU.

It looks atrocious and makes no sense here. Have you ever seen a dictionary or encyclopedia that uses garbage that looks like this? I sure haven’t. And I can assure you that the professional linguistics literature in refereed journals never does so either.

The root cause of this horrific misformatting that plagues ELU seems to be that programmers more accustomed to the programming-related StackExchange sites than they are to correctly typeset English text come to our English Language & Usage site expecting to use ˋbackticksˋ when they wish to make a use–mention distinction, which a programmer equates to making a literal out of something:

In written language, mentioned words or phrases often appear between quotation marks (“Chicago” contains three vowels) or in italics (When I say honey, I mean the sweet stuff that bees make), and style authorities such as Strunk and White insist that mentioned words or phrases must always be made visually distinct in this manner.

Here at ELU, we prefer that one set mentions in an italic face, the way reputable dictionaries always do. If I were to mention the word discombobulate, I would write it that way, never as discombobulate. See the immense difference?

All works on language work this way. Notice the way the Oxford English Dictionary (OED) employs italics in the Etymology section of discubiture when making the use–mention distinction for citing the Latin discubitura, discubit-, and discumbere:

OED example of use-mention distinction


Fixing your text

It isn’t just the OED that works this way. All texts that talk about language do the same thing.

So how should your text be optimally rendered? Those should respectively be a > quotation for the full sentence and then either a “quoted phrase” or a *quoted phrase* for the embedded part. One employs an italic face for the use–mention distinction here, not ˋugly monospaceˋ, which looks unprofessional.

Here follow two different alternate representations of your text, both superior to the “ransom-note look” that using an 𝚞𝚐𝚕𝚢 𝚖𝚘𝚗𝚘𝚜𝚙𝚊𝚌𝚎𝚍 𝚏𝚘𝚗𝚝 introduces.


Superior Formatting: #1 of 2

Here I indent your full sentence using a > instead of whitespace, which makes it look correct, and I use paired quotation marks around the “inlined” instance. I’ve put the whole thing in a <pre> ... </pre> preformatted literal block so that all markdown formatting characters are displayed as literals, not as markdown:

I need an adjective. I am describing a programming language that has
features from many other existing languages. The sentence I want to
use it in is along the lines of: 

> In short, this language is a ______ of {*list of names of other languages*}.

I know I could use “this language has features from ______”,
but this seems a better fit to me.

Here’s what that example should look like:

reformatted example one of two


Superior Formatting: #2 of 2

There is of course a problem with using paired quotation marks for the mention case, and that is that we use quotation marks for so many other things, such as when I referred above to an “inlined” mention case, there using scare-quotes for their customary meaning. Therefore, an italic face is usually to be preferred over mere quotes. Here I also choose a bullet for the citation sentence rather than the citation indentation style.

I need an adjective. I am describing a programming language that has
features form many other existing languages. The sentence I want to
use it in is along the lines of: 

* In short, this language is a ______ of {*list of names of other languages*}.

I know I could use *this language has features from ______*,
but this seems a better fit to me.

Here’s what that should look like:

reformatted example number two


Exceptions to the rule

There are a few places where one has no choice but to employ the StackExchange literalizing markdown, but it is never for the use–mention case per se.

  1. If ever one needs to show actual formatting characters in the markdown, like to tell someone who wants something set it italics to type in the literal characters *set in italics*. It is for this reason that I indented the two reformatted versions I displayed above, so that you could see the literal markdown characters themselves, and how it should be done.

  2. For the formatting of actual tabular information, when exact column alignment is therefore required. So from this fine answer, we see:

                                     BNC    COCA       Google

     ARE NOT CURRENTLY (BEING)     18 (1)  70 (8)   72.6M (21.9M)
     ARE CURRENTLY NOT (BEING)      4 (0)  17 (0)   10.1M ( 9.6M)

Here is what that should look like:

formatted table example

Oh, ick!

That’s suddenly a startling grey against our otherwise tasteful field of subdued peach, like a light beige or an agèd ivory. Our normal background color is meant to suggest the color of old pages in a book, at least by intent. That awful grey splattered atop it looks like so much water damage.

Which leads to my next point, in which we return to the one aspect of your original bug report that was indeed spot on the money, and should be fixed.


Where you were spot on the money

Now, you might justly point out that the background color on the preformatted section is an atrocious clash with that of the site in general. That was part of your original point, and I agree with you about that. There is certainly room for improvement there.

But the actual valid uses of preformatted text are so rare that I don’t think anyone has paid much attention to the matter.

A related bug is that using indentation to make a table produces inferior results to using an actual <pre> ... </pre> block as I have done here.


Summary: Use Italics

But apart from those two very special — and frankly rather uncommon — instances, you do not want to use the terrible monospaced ugliness here on English Language & Usage, nor on any other non-coding site. For not only does it clash with custom and established practice, it is aesthetically discomforting in the extreme.

You instead want to use one of the other mechanisms outlined above, all of which which are less unsettling to the eye — normally italics.



Addendum for SE Staff

This is an example of the use–mention distinction citation not working in a posting.

This is an example of the
[use–mention distinction](http://en.wikipedia.org/wiki/Use–mention_distinction) 
citation not working in a posting.
share
    
So my use is incorrect.. But the problem still has to be fixed. Right? –  Schoolboy May 4 at 16:55
    
@Schoolboy Right! :) –  tchrist May 4 at 17:00
1  
I upvoted for the first line, so commenting is the only way I have to say how much I agree with the rest of the answer. –  TimLymington May 5 at 14:36
    
On rare occasions I have used preformatted text / backticks, mainly because I already had two or three words in italics in my answer that I felt an "ugly tiny grey box" would highlight an expression more effectively. If I were writing a document, I'd have underlined those words, expressions etc. Would it be possible in the future to underline text on EL&U? Is it such a bad idea? –  Mari-Lou A May 7 at 21:34
    
@Mari-LouA The Powers Above have repeatedly denied all requests for underlining, calling it too confusable for h̲y̲p̲e̲r̲l̲i̲n̲k̲s̲. So I guess it is i̲m̲p̲o̲s̲s̲i̲b̲l̲e̲. Oh well! :) –  tchrist May 7 at 21:40
    
I'm jealous! You can underline stuff. Not fair! pout :) –  Mari-Lou A May 7 at 21:42
2  
@Mari-LouA 𝔚𝔦𝔱𝔥 𝔘𝔫𝔦𝔠𝔬𝔡𝔢, 𝓉𝓇𝓊𝓁𝓎 𝒶𝓁𝓁 𝒕𝒉𝒊𝒏𝒈𝒔 𝒂𝒓𝒆 𝒑̲𝒐̲𝒔̲𝒔̲𝒊̲𝒃̲𝒍̲𝒆̲! –  tchrist May 8 at 0:22
1  
Erm... is my seeing a series of tiny boxes normal? In the second and Fixing your text paragraphs, I see a line of boxes. Should I be seeing something else? –  Mari-Lou A May 8 at 6:12
    
@Mari-LouA I can’t show what it should look like in a comment for want of image support. “Normal” would not be the operative term. What’s happening id I’ve semi-wickedly nabbed letters from the Unicode block for “Mathematical Alphanumeric Symbols”. There are intended for use only in math equations, like here where I use U+1D45B MATHEMATICAL ITALIC SMALL N in the way it was intended to be used, unlike here, where I’m wicked again. (continued) –  tchrist May 8 at 7:20
    
@Mari-LouA Those code points (“characters”) didn’t become part of the Unicode Standard till March of 2001 — 13 years ago. Almost all new computers today come with font support for those kinds, but it may be that yours is either older, or that it’s simply missing a needed font, or if it’s Microsoft, has a poor font-substitution algorithm. You can usually fix this by installing George Douros’s free and very useful Symbola font. Many of his other fonts are quite good, too. –  tchrist May 8 at 7:27
    
@Mari-LouA However, the underlining trick is something else. There I am using the normal ASCII characters but following each one with U+0332 COMBINING LOW LINE, thereby allowing you to underline what ever suits your fancy. By putting it in ˋb̲a̲c̲k̲t̲i̲c̲k̲s̲ˋ, it actually looks like a tag. Other p̳o̳s̳s̳i̳b̳i̳l̳i̳t̳i̳e̳s̳ exist, although s̳̿o̳̿m̳̿e̳̿ m̳̿a̳̿y̳̿ g̳̿e̳̿t̳̿ y̳̿o̳̿u̳̿ t̳̿a̳̿l̳̿k̳̿e̳̿d̳̿ a̳̿b̳̿o̳̿u̳̿t̳̿. –  tchrist May 8 at 7:35
    
Weirdly I didn't get any inbox notification. As it's one of my insomniac nights I just happened to revisit, and read your answer. My laptop is about five years old, OS is Vista, which might explain why I'm seeing a row of little empty bricks. I'll install the font you suggested at a more sensible hour. Thank you for your kind explanation :) –  Mari-Lou A May 9 at 3:16
1  
To some extent, the lack of a highlighting convention in print style manuals is a limitation of print-based typesetting technologies. While the use of monospaced fonts in this case certainly is ugly, italics and quotation marks are in most Anglophone style guides very heavily semantically overloaded; so I find myself tempted to use highlighting as another distinguishing factor, piggybacking (as you suggest) on the convention used in technical manuals for code. But ... heck, a style is something that has to be agreed to by the discourse community, and I bow to the consensus. :-) –  outis nihil May 9 at 15:47
    
I've installed the font symbola, rebooted my laptop, but I'm still seeing a row of empty little boxes/squares. If I'm seeing this, I'm wondering who else is too? Maybe a line of tiny empty squares is supposed to be seen? :( –  Mari-Lou A May 14 at 9:44
1  
For the record, Safari on iOS also shows little boxes, while of course the desktop version shows the monospaced font correctly (and doesn't annoyingly ‘correct’ monospaced font to ‘monos paved don't’ either!). On the other hand, the default monospaced font in the desktop version has completely fubared kerning, so the faux-under-and-overlined text is completely garbled and illegible there—but renders perfectly on iOS! Go figure. –  Janus Bahs Jacquet May 16 at 13:46

This is what you should be seeing, Mari Lou:

unicode picture

I don’t know why you are not seeing them after having done those things.

share
1  
Ooh, pretty! Me like. My laptop OS isn't that old, 2007, Windows Vista Home Premium. Well, now you know what I've been seeing every time you posted a unicode thingymajig. –  Mari-Lou A May 14 at 20:22

Since this seems to have become a sort of weird-formatting troubleshooting thread, I’ll chime in as well with a bit of Macness. :-)

Safari Mobile (7.0) on iOS 7.1.1:

Safari Desktop (6.1.3) on OS X 10.

Chrome (34.0.1847.131) renders everything like Safari; Firefox (28.0) renders everything correctly; Opera (12.15.1748) renders all the fancy Unicode stuff correctly, but surprisingly renders the italics in headers wrong, ‘doubling’ the italicising (using the correct italic variant of Georgia, but faux-italicising it).

share

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .