As you can see, Asciidoctor (the engine on GitHub and Gist) doesn't yet
support that feature...so you get the code tags (actually Asciidoctor uses
<tt>, but pretty much the same thing).

-Dan

On Mon, Mar 11, 2013 at 3:38 PM, Dan Allen <[email protected]> wrote:

> Aha! I can see it right away. Your problem is the plaintext setting. That
> should not be needed. That actually disables creating HTML output. See if
> removing that works for you (I've never used that setting in all my use of
> AsciiDoc).
>
> -Dan
>
>
> On Mon, Mar 11, 2013 at 3:29 PM, Shailen Tuli <[email protected]>wrote:
>
>> Thanks, Dan.  Here's the gist:
>>
>> https://gist.github.com/shailen/5137907
>>
>> Since, github does a lovely job of converting the backticks, I'm not sure
>> that'll help that much. Here is the asciidoc file, sample.asciidoc:
>>
>>
>> = Dart Cookbook
>> :author: Shailen Tuli
>> :encoding: UTF-8
>> :plaintext:
>>
>> == Strings
>>
>> A Dart string represents a sequence of characters encoded in UTF-16.
>> Decoding UTF-16 yields Unicode code points. Borrowing terminology from
>> Go, Dart uses the term `rune` for an integer representing a Unicode code
>> point.
>>
>> === Interpolating expressions inside strings
>>
>> An interpolated string, `string ${expression}` is equivalent to the
>> concatenation of the strings 'string ' and `expression.toString()`.
>> Consider this code:
>>
>> -----------------------------------------------------
>> var four = 4;
>> var seasons = 'The $four seasons'; // 'The 4 seasons'
>> -----------------------------------------------------
>>
>>
>> On Monday, March 11, 2013 2:13:11 PM UTC-7, Dan Allen wrote:
>>
>>> Great. Also, could you include a snippet from the document so that we
>>> are working on the same sample text?
>>>
>>> The best thing to do is to shove it into a gist => gist.github.com
>>>
>>> -Dan
>>>
>>>
>>> On Mon, Mar 11, 2013 at 8:59 PM, Shailen Tuli <[email protected]>wrote:
>>>
>>>> Dan,
>>>>
>>>> It is version 8.6.8 and I got the tarball and followed the instructions
>>>> outlined at 
>>>> http://www.methods.co.nz/**asciidoc/INSTALL.html#X1<http://www.methods.co.nz/asciidoc/INSTALL.html#X1>
>>>> .
>>>>
>>>> Many thanks for your help.
>>>>
>>>> - Shailen
>>>>
>>>>
>>>> On Monday, March 11, 2013 12:37:02 PM UTC-7, Dan Allen wrote:
>>>>
>>>>> Could you identify the AsciiDoc version you are using and how you
>>>>> installed it? That way, I can be sure I'm making suggestions that are
>>>>> relevant to your environment.
>>>>>
>>>>> -Dan
>>>>>
>>>>>
>>>>> On Mon, Mar 11, 2013 at 8:27 PM, Shailen Tuli <[email protected]>wrote:
>>>>>
>>>>>> Hi Dan,
>>>>>>
>>>>>> Thank you for your detailed response. Unfortunately, using the +
>>>>>> doesn't seem to work (it just shows up as a literal +). Using backticks
>>>>>> with the .conf file that you showed also doesn't solve the problem (the
>>>>>> backticks show up as literals). The backticked text is not getting placed
>>>>>> in *any* tag, not even a <span> .
>>>>>>
>>>>>> And I get the problem whether I build to xhtml11 or html5.
>>>>>>
>>>>>> I'm using the following build commands:
>>>>>>
>>>>>> asciidoc -b html5 -a toc book.asciidoc
>>>>>>
>>>>>> or
>>>>>>
>>>>>> asciidoc -dbook -a toc book.txt
>>>>>>
>>>>>> Any idea where the problem may lie?
>>>>>>
>>>>>> - Shailen
>>>>>>
>>>>>>
>>>>>> On Monday, March 11, 2013 11:46:14 AM UTC-7, Dan Allen wrote:
>>>>>>
>>>>>>> Shailen,
>>>>>>>
>>>>>>> You can continue to use backticks, though a more lightweight
>>>>>>> approach is to plus symbols. The reason I say "more lightweight" is 
>>>>>>> because
>>>>>>> the backticks actually take the text out of the document when 
>>>>>>> substitutions
>>>>>>> are performed, then restores it afterwards. By doing so, nothing
>>>>>>> is interpreted inside of the backticks. The plus symbols simply get 
>>>>>>> wrapped
>>>>>>> inplace. There are cases when you undesired substitutions when using the
>>>>>>> plus symbols...but it's not too common.
>>>>>>>
>>>>>>> My recommendation is to use backticks when you find you need them,
>>>>>>> otherwise the plus signs.
>>>>>>>
>>>>>>> Examples:
>>>>>>>
>>>>>>> +foo.bar()+
>>>>>>> `foo.bar()`
>>>>>>>
>>>>>>> For some strange reason, the html5 backend in AsciiDoc is configured
>>>>>>> to wrap literal text in <span class="monospaced"></span> instead
>>>>>>> of <code></code>.
>>>>>>>
>>>>>>> This can be easily changed by including an override configuration
>>>>>>> file in the same directory as the source file. If your source file is 
>>>>>>> named
>>>>>>> document.asciidoc, then create document.conf and populate it with:
>>>>>>>
>>>>>>> ifdef::basebackend-html[]
>>>>>>>
>>>>>>> [tags]
>>>>>>> # +code+
>>>>>>> monospaced=<code{1? class="{1}"}>|</code>
>>>>>>>
>>>>>>> [literal-inlinemacro]
>>>>>>> # `code`
>>>>>>> <code>{passtext}</code>
>>>>>>>
>>>>>>> endif::basebackend-html[]
>>>>>>>
>>>>>>> (The xhtml backend uses <code> tags, so you can consult it as a
>>>>>>> reference: %asciidoc_install%/xhtml11.**con****f)
>>>>>>>
>>>>>>> Consult the user guide for other ways to customize the output.
>>>>>>>
>>>>>>> -Dan
>>>>>>>
>>>>>>> On Mon, Mar 11, 2013 at 6:06 PM, Shailen Tuli 
>>>>>>> <[email protected]>wrote:
>>>>>>>
>>>>>>>> I'm switching over from markdown to asciidoc and have a question.
>>>>>>>> In my markdown file, I use backticks to indicate code font 
>>>>>>>> (`foo.bar()`).
>>>>>>>> When this is converted to html, the text gets placed inside code blocks
>>>>>>>> (<code>foo.bar()</code>).
>>>>>>>>
>>>>>>>> How should I format a text fragment in asciidoc if I want it to
>>>>>>>> appear within code blocks when the document is converted to html?  Many
>>>>>>>> thanks.
>>>>>>>>
>>>>>>>> - Shailen Tuli
>>>>>>>>
>>>>>>>> --
>>>>>>>> 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/**grou****
>>>>>>>> ps/opt_out <https://groups.google.com/groups/opt_out>.
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>> --
>>>>>>> Dan Allen
>>>>>>> Principal Software Engineer, Red Hat | Author of Seam in Action
>>>>>>> Registered Linux User #231597
>>>>>>>
>>>>>>> http://google.com/profiles/**dan****.j.allen<http://google.com/profiles/dan.j.allen>
>>>>>>> http://mojavelinux.com
>>>>>>> http://mojavelinux.com/**seamina****ction<http://mojavelinux.com/seaminaction>
>>>>>>>
>>>>>>  --
>>>>>> 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/**grou**ps/opt_out<https://groups.google.com/groups/opt_out>
>>>>>> .
>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>>
>>>>> --
>>>>> Dan Allen
>>>>> Principal Software Engineer, Red Hat | Author of Seam in Action
>>>>> Registered Linux User #231597
>>>>>
>>>>> http://google.com/profiles/**dan**.j.allen<http://google.com/profiles/dan.j.allen>
>>>>> http://mojavelinux.com
>>>>> http://mojavelinux.com/**seamina**ction<http://mojavelinux.com/seaminaction>
>>>>>
>>>>  --
>>>> 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
>>> Principal Software Engineer, Red Hat | Author of Seam in Action
>>> Registered Linux User #231597
>>>
>>> http://google.com/profiles/**dan.j.allen<http://google.com/profiles/dan.j.allen>
>>> http://mojavelinux.com
>>> http://mojavelinux.com/**seaminaction<http://mojavelinux.com/seaminaction>
>>>
>>  --
>> 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.
>>
>>
>>
>
>
>
> --
> Dan Allen
> Principal Software Engineer, Red Hat | Author of Seam in Action
> Registered Linux User #231597
>
> http://google.com/profiles/dan.j.allen
> http://mojavelinux.com
> http://mojavelinux.com/seaminaction
>



-- 
Dan Allen
Principal Software Engineer, Red Hat | Author of Seam in Action
Registered Linux User #231597

http://google.com/profiles/dan.j.allen
http://mojavelinux.com
http://mojavelinux.com/seaminaction

-- 
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.


Reply via email to