February 24, 2017 Re: ddoc: Can I escape a colon? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Nick Sabalausky (Abscissa) | On Friday, 24 February 2017 at 02:50:27 UTC, Nick Sabalausky (Abscissa) wrote: > What I'd kinda like to do is put together a D doc generator that uses, uhh, probably markdown. My dpldocs.info generator continues to progress and I'm almost ready to call it beta and let other people use it. It's syntax is a hybrid of ddoc and markdown. Take a look at the sample page: http://dpldocs.info/experimental-docs/test.html Though I don't support user-defined macros, it just has a hardcoded list of common ones to support Phobos source, and then a bunch of "magic macros" and a few special syntaxes for really common things. Like for links, I went with a Wikipedia-inspired [url|text] bracket. (or if it is just a url, you don't need to bracket it at all). You can also mention a name there, and it searches your imported namespaces to look it up. import std.range; /// See [isOutputRange] for more. void foo() {} That [isOutputRange] will look it up inside std.range and link straight to std.range.primitives.isOutputRange. Or you can do like [http://dlang.org|The official D Website] and it will turn that into the natural <a href="http://dlang.org>The official D Website</a> for you. There's a few more syntax things you can see in that sample link above and a few more I have planned, but I find it is already really pretty usable. And then, of course, it has enough knowledge of D to make even complex functions look pretty readable: http://dpldocs.info/experimental-docs/std.algorithm.sorting.sort.html http://dpldocs.info/experimental-docs/arsd.simpledisplay.SimpleWindow.this.1.html and so on. |
February 23, 2017 Re: ddoc: Can I escape a colon? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Adam D. Ruppe | On 02/23/2017 10:36 PM, Adam D. Ruppe wrote:
> On Friday, 24 February 2017 at 02:50:27 UTC, Nick Sabalausky (Abscissa)
> wrote:
>> What I'd kinda like to do is put together a D doc generator that uses,
>> uhh, probably markdown.
>
> My dpldocs.info generator continues to progress and I'm almost ready to
> call it beta and let other people use it.
>
> It's syntax is a hybrid of ddoc and markdown. Take a look at the sample
> page: http://dpldocs.info/experimental-docs/test.html
Oh, nice. The $(MATH stuff is especially cool (although unlikely to be useful in my libs - damn! I wanna put that to use!).
Looking forward to seeing that hit beta (and beyond) and trying that out.
|
February 26, 2017 Re: ddoc: Can I escape a colon? | ||||
---|---|---|---|---|
| ||||
Posted in reply to Nick Sabalausky (Abscissa) | On Thursday, 23 February 2017 at 21:04:39 UTC, Nick Sabalausky (Abscissa) wrote:
> Suppose I want ddoc output to include this line:
>
> --------------
> Note: Blah blabbety blah
> --------------
>
> But the colon causes "Note" to be considered a section header. Is there a way to escape the ":" so that it's displayed as expected, but doesn't trigger a section?
You can put a space before : and ddoc, or ddox won't treat it as a section.
-----------------
Note : Blah blabbety blah
-----------------
|
Copyright © 1999-2021 by the D Language Foundation