www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.announce - Harbored-mod 0.1: A documentation generator with DDoc and Markdown

reply "Kiith-Sa" <kiithsacmp gmail.com> writes:
Harbored-mod is a documentation generator based on Brian Schott's
Harbored.

--------
Features
--------

It supports (a non-conflicting subset of) Markdown besides DDoc,
so Markdown can be used together with DDoc in documentation
comments.


Some other features:

* Decent defaults. `hmod source` will generate rather usable
   documentation very similar to this one:
* CSS and main page content can be overridden.
   Extra content can be added to the table of contents
   (e.g. links to non-DDoc generated documentation,
    I use it to link to tutorials/articles written in
    ReStructuredText)
* Documented config file you can write all command-line options
   to, so just typing `hmod` will regenerate the docs.
* Generated file paths are same as those generated by DDox,
   so links will not break if moving from one to the other.


----------------------------------------------------------
Examples of generated docs (work-in-progress Tharsis docs)
----------------------------------------------------------

http://defenestrate.eu/docs/tharsis-core/api/tharsis/entity/entitymanager/EntityManager.html

http://defenestrate.eu/docs/tharsis-core/api/tharsis/entity/componenttypeinfo/ImmutableRawComponent.html

http://defenestrate.eu/docs/tharsis-core/api/tharsis/entity/processtypeinfo/prioritizeProcessOverloads.html


-----
Links
-----

* GitHub: https://github.com/kiith-sa/harbored-mod
* Original Harbored: https://github.com/economicmodeling/harbored


----------
Background
----------

Harbored-mod started as an attempt to remove things I didn't want
from Harbored (inability to work without JS, frames, etc.) but
I ended up with more changes than I originally intended, and I
think at this point it might be useful for other people as well.

I pushed it into a separate repository because I don't think at
this point it can be sanely merged into harbored (plus there are
those features I removed).
Dec 30 2014
parent "Basile Burg" <basile.burg gmx.com> writes:
On Tuesday, 30 December 2014 at 14:46:06 UTC, Kiith-Sa wrote:
 ... and I
 think at this point it might be useful for other people as well.
Thx, it works fine (altough I haven't tested the markdown features yet) and fixes an issue I had with the original harbored. If someone want to build **harbored-mod** using Coedit, there is a new version of an old tutorial. https://github.com/BBasile/Coedit/wiki#integration-of-the-documentation-generator-harbored-mod-to-coedit
Dec 30 2014