Re: [RFC] A first shot at asciidoc-based formatted docs

From	Keith Packard <keithp@keithp.com>
Newsgroups	linux.kernel
Subject	Re: [RFC] A first shot at asciidoc-based formatted docs
Date	2016-02-13 04:30 +0100
Message-ID	<r1z4e-7Jv-3@gated-at.bofh.it> (permalink)
References	<qUYK5-2Ts-3@gated-at.bofh.it> <qVaBA-3Uj-3@gated-at.bofh.it> <r0qw2-2Yx-3@gated-at.bofh.it> <r0M3x-pI-27@gated-at.bofh.it>
Organization	linux.* mail to news gateway

Show all headers | View raw

[Multipart message — attachments visible in raw view] - view raw

Keith Packard <keithp@keithp.com> writes:

> The goal would be to create an html document which could be used without
> javascript, and that would work without css as well.

I've managed to hack up asciidoc to generate the TOC within the
document, rather than requiring javascript. The changes are fairly
minor, and seem to add a nice generalization to the asciidoc environment
which should be useful in other contexts.

The changes consist of two bits -- the first is to allow the diversion
of some text from .conf file sections, the second is to postpone some
attribute processing to a second pass over the document so that the TOC
can be inserted in the desired location, instead of requiring that it be
placed at the bottom.

I've sent these changes upstream, and also pushed them to a personal
asciidoc git repository at :

        git clone git://keithp.com/git/asciidoc

-- 
-keith

Back to linux.kernel | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Re: [RFC] A first shot at asciidoc-based formatted docs Jonathan Corbet <corbet@lwn.net> - 2016-02-10 01:10 +0100
  Re: [RFC] A first shot at asciidoc-based formatted docs Daniel Vetter <daniel.vetter@ffwll.ch> - 2016-02-10 09:10 +0100
    Re: [RFC] A first shot at asciidoc-based formatted docs Jani Nikula <jani.nikula@intel.com> - 2016-02-10 15:10 +0100
      Re: [RFC] A first shot at asciidoc-based formatted docs Jani Nikula <jani.nikula@intel.com> - 2016-02-10 17:20 +0100
      Re: [RFC] A first shot at asciidoc-based formatted docs Jonathan Corbet <corbet@lwn.net> - 2016-02-10 22:00 +0100
        Re: [RFC] A first shot at asciidoc-based formatted docs Keith Packard <keithp@keithp.com> - 2016-02-11 16:20 +0100
    Re: [RFC] A first shot at asciidoc-based formatted docs Jonathan Corbet <corbet@lwn.net> - 2016-02-10 21:50 +0100
  Re: [RFC] A first shot at asciidoc-based formatted docs Keith Packard <keithp@keithp.com> - 2016-02-11 00:10 +0100
    Re: [RFC] A first shot at asciidoc-based formatted docs Jani Nikula <jani.nikula@intel.com> - 2016-02-11 14:50 +0100
      Re: [RFC] A first shot at asciidoc-based formatted docs Keith Packard <keithp@keithp.com> - 2016-02-11 16:30 +0100
    Re: [RFC] A first shot at asciidoc-based formatted docs Keith Packard <keithp@keithp.com> - 2016-02-13 04:30 +0100

csiph-web