| Re: [AD] Documentation system 2009 |
[ Thread Index |
Date Index
| More lists.liballeg.org/allegro-developers Archives
]
On 2009-01-19, Elias Pschernig <elias.pschernig@xxxxxxxxxx> wrote:
> 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..
I'll ask on a.cc.
>
> Oh, and what is this comment for in inc.a.txt?
>
> <!-- keep blank line for correct HTML -->
>
The blank line is to separate the following </div> from the last list
item.
> 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?
I didn't realise it was causing extra blanks in the sidebar.
Peter