| Re: IDLdoc: Embedded HTML code [message #81622 is a reply to message #81591] |
Fri, 05 October 2012 08:01  |
Michael Galloy
Messages: 1114
Registered: April 2006
|
Senior Member |
|
|
On 10/5/12 8:05 AM, Yngvar Larsen wrote:
> On Tuesday, 2 October 2012 19:32:49 UTC+2, Mike Galloy wrote:
>> On 10/2/12 10:51 AM, Yngvar Larsen wrote:
>>
>>> A useful feature of IDLdoc when MARKUP_STYLE='verbatim', is that you may embed small snippets of HTML code directly in the text and it will show up correctly in the generated HTML output. For instance a small table. (Maybe this is considered cheating, and not really intended functionality ?) However, when using MARKUP_STYLE='rst', this trick does not work anymore. There are embedding options for graphics and links, but I cannot find anything about embedding HTML code.
>
>> Yes, you are right the rst style does not allow HTML embedding, but the
>> other styles (IDL, IDLdoc, and verbatim) do.
>>
>> One workaround right now would be to use a separate docformat statement
>> for that single file, though that is not very satisfactory for the rest
>> of the comments.
>
> Yes, that is my problem here.
>
>>
>>
>>
>> Adding the html directive (and maybe latex as well) as a feature
>> request. They will only show up when using that output type.
>
> Another possibility is support for some simple markup like textile (http://textile.thresholdstate.com) and/or the Wiki formatting system used by trac.
>
Yes, eventually I hope to have rst markup support for all common
features like lists and tables. It already supports links, code (inline
and block), and headers.
Mike
--
Michael Galloy
www.michaelgalloy.com
Modern IDL: A Guide to IDL Programming (http://modernidl.idldev.com)
Research Mathematician
Tech-X Corporation
|
|
|
|
comp.lang.idl-pvwave archive
Members
Search
Help
Login
Home
