On 04/06/13 13:30, Dan Allen wrote: > Or here: > > http://asciidoctor.org/docs/asciidoc-quick-reference/#formatted-text > > and here (though this one does not have a specific example for your use > case): > > http://asciidoctor.org/docs/asciidoc-writers-guide/#mild-punctuation-strong-impact
Nice documentation Dan. Cheers, Stuart > > -Dan > > > > On Mon, Jun 3, 2013 at 6:22 PM, Bruce Eckel <[email protected] > <mailto:[email protected]>> wrote: > > Thanks, that worked. I feel like I should have been able to find it > in the docs -- where should I have been looking? > > > On Monday, June 3, 2013 5:34:27 PM UTC-6, Dan Allen wrote: > > Bruce, > > In this case, what you are looking for is called "unconstrained" > quoted text (in AsciiDoc, "quoted text" is just a way of saying > "formatted text"). > > Unconstrained quotes may appear anywhere in the text, such as > around a segment of a word. They typically consist of two > characters. > > Here's how you would use unconstrained quotes to get the > monospace formatting you need: > > ++Int++s > > That will output: > > <code>Int</code>s > > You'll notice that I used pluses instead of backticks here. > Unless the formatted content needs to be escaped from AsciiDoc > substitutions, it's best to use pluses for monospaced text. > Backticks work by taking the content out of the flow of the text > while the text is processed, then reinserting the text back in > at the placeholder positions. The pluses merely wrap monospace > tags (e.g., <code>) around the text (in the same way the * wraps > the text in <strong> and _ wraps the text in <em>). > > If you do need to escape the text (for instance if it contains > something that looks like an attribute reference), using double > backticks won't work. Instead, you need to use the double dollar > (escaped text without applying special formatting to the result) > combined with the unconstrained monospace quotes: > > ++$${Int}$$++s > > Which would output: > > <code>{Int}</code>s > > But, those situations are pretty rare :) > > -Dan > > > > On Mon, Jun 3, 2013 at 2:14 PM, Bruce Eckel <[email protected]> > wrote: > > Most of the time this happens when I want to pluralize > something: > > `Int`s > > doesn't work, it requires a space which then looks odd: > > `Int` s > > I notice that a comma does *not* require a space: > > `Int`, > > Works. > > Thanks for any help. > > -- > You received this message because you are subscribed to the > Google Groups "asciidoc" group. > To unsubscribe from this group and stop receiving emails > from it, send an email to asciidoc+u...@__googlegroups.com. > To post to this group, send email to [email protected]. > > Visit this group at > http://groups.google.com/__group/asciidoc?hl=en > <http://groups.google.com/group/asciidoc?hl=en>. > For more options, visit > https://groups.google.com/__groups/opt_out > <https://groups.google.com/groups/opt_out>. > > > > > > > -- > Dan Allen | http://google.com/profiles/__dan.j.allen > <http://google.com/profiles/dan.j.allen> > > -- > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, > send an email to [email protected] > <mailto:asciidoc%[email protected]>. > To post to this group, send email to [email protected] > <mailto:[email protected]>. > Visit this group at http://groups.google.com/group/asciidoc?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > > > > > > -- > Dan Allen | http://google.com/profiles/dan.j.allen > > -- > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send > an email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
