www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - Ddoc to HTML tool?

reply Jacob Carlborg <doob me.com> writes:
What's the best way to generate HTML from a snippet of Ddoc? I've 
extracted the Ddoc from a symbol using DCD and would like to display it 
in a text editor. Ideally it should be a command line tool.

-- 
/Jacob Carlborg
Aug 10 2016
parent reply Kagamin <spam here.lot> writes:
dmd generates html from dd files; example: 
https://github.com/dlang/dlang.org/blob/master/download.dd
Aug 10 2016
next sibling parent reply Jacob Carlborg <doob me.com> writes:
On 10/08/16 16:48, Kagamin wrote:

 dmd generates html from dd files; example:
 https://github.com/dlang/dlang.org/blob/master/download.dd


Thanks, I didn't know that. It's not ideal, it adds some other tags that 
I would like to avoid, i.e. "Page generated by Ddoc", but it works.

-- 
/Jacob Carlborg
Aug 10 2016
parent reply Adam D. Ruppe <destructionator gmail.com> writes:
On Wednesday, 10 August 2016 at 17:04:20 UTC, Jacob Carlborg 
wrote:

 Thanks, I didn't know that. It's not ideal, it adds some other 
 tags that I would like to avoid, i.e. "Page generated by Ddoc", 
 but it works.


those are in the macro definition file, you can make your own and 
simplify/improve.
Aug 10 2016
parent Jacob Carlborg <doob me.com> writes:
On 10/08/16 19:10, Adam D. Ruppe wrote:


 those are in the macro definition file, you can make your own and
 simplify/improve.


I replaced the DDOC macro with my own version, that worked fine. Thanks.

-- 
/Jacob Carlborg
Aug 10 2016
prev sibling parent Jacob Carlborg <doob me.com> writes:
On 10/08/16 16:48, Kagamin wrote:

 dmd generates html from dd files; example:
 https://github.com/dlang/dlang.org/blob/master/download.dd


Unfortunately it looks like Standard Sections [1] are not handled in the 
same way as when generating documentation from D source files. They're 
handled just as any other text.

[1] https://dlang.org/spec/ddoc.html#standard_srction

-- 
/Jacob Carlborg
Aug 10 2016