Re: [AD] Documentation system 2009

[Elias Pschernig <elias.pschernig@xxxxxxxxxx>]

On Sun, 2009-01-18 at 23:47 +1100, Peter Wang wrote:
> On 2009-01-15, Elias Pschernig <elias.pschernig@xxxxxxxxxx> wrote:
> > I myself don't see much reason to generate Natural Docs docs any longer
> > - I copied over the naturaldocs web-updater script to publish the HTML
> > version of the new docs on the SF site:
> > 
> > http://www.liballeg.org/a5docs/
> > 
> > We apparently still need some kind of front page and a navigation bar.
> > And a search box like with Natural Docs might be nice.
> 
> Does anyone have a suggestion for a search box we can borrow?
> 

I could adapt the search box on the front page, but it's an old-style
server-side script, so no interactive search results display like with
the AJAX one used by NaturalDocs..

Oh, and what is this comment for in inc.a.txt?

<!-- keep blank line for correct HTML -->

According to markdown documentation [1]:
"""
If list items are separated by blank lines, Markdown will wrap the items
in <p> tags in the HTML output.
"""

So why would we want a "<p> tag" there?

1 http://daringfireball.net/projects/markdown/syntax#list

-- 
Elias Pschernig <elias@xxxxxxxxxx>