Asciidoctor :: Discussion

Documentation - Inject Footer and Header

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

6 messages Options

SigmaSquared

Documentation - Inject Footer and Header

Is there any documentation, or is it even possible, to insert another .adoc (or another file type) as a Footer or Header?

LightGuardjp

Re: Documentation - Inject Footer and Header

Take at look at docinfo files: http://asciidoctor.org/docs/user-manual/#docinfo-file

On Mon, Oct 5, 2015 at 9:50 AM, SigmaSquared [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Is there any documentation, or is it even possible, to insert another .adoc (or another file type) as a Footer or Header?

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Documentation-Inject-Footer-and-Header-tp3813.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Jason Porter
http://en.gravatar.com/lightguardjp

mojavelinux

Re: Documentation - Inject Footer and Header

Administrator

And it's scheduled for 1.5.3 to allow docinfo files to be AsciiDoc. Though it's possible to accomplish with 1.5.2 using the DocinfoProcessor extension point.

Cheers,

-Dan

Le 5 oct. 2015 10:54 AM, "LightGuardjp [via Asciidoctor :: Discussion]" <[hidden email]> a écrit :

Take at look at docinfo files: http://asciidoctor.org/docs/user-manual/#docinfo-file

On Mon, Oct 5, 2015 at 9:50 AM, SigmaSquared [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Is there any documentation, or is it even possible, to insert another .adoc (or another file type) as a Footer or Header?

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Documentation-Inject-Footer-and-Header-tp3813.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

--
Jason Porter
http://en.gravatar.com/lightguardjp

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Documentation-Inject-Footer-and-Header-tp3813p3814.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Ted

Re: Documentation - Inject Footer and Header

You can also "Include" files, if that's what you meant: http://asciidoctor.org/docs/user-manual/#include-directive

- Ted @TedAtCIS

SigmaSquared

Re: Documentation - Inject Footer and Header

In reply to this post by mojavelinux

It appears that this footer & header 'injection' using docinfo, at this point, only works with HTML and docbook as the output file types. Is this also true for DocinfoProcessor?

Unlike the link provided by LightGuardjp, DocinfoProcessor's documentation didn't say what the output file types were. However, ManpageMacro that's used in the example for DocinfoProcessor, references HTML in it's example. I can only guess that the answer is that the output files for both ways, is only for html and docbook, but I want to be sure.

Excuse me if i'm not asking the right questions, as i'm just now learning about Asciidoctor.

Many thanks.

mojavelinux

Re: Documentation - Inject Footer and Header

Administrator

On Mon, Oct 5, 2015 at 9:01 PM, SigmaSquared [via Asciidoctor :: Discussion] <[hidden email]> wrote:

It appears that this footer & header 'injection' using docinfo, at this point, only works with HTML and docbook as the output file types. Is this also true for <a href="http:// https://github.com/asciidoctor/asciidoctorj#docinfoprocessor">DocinfoProcessor?

The DocinfoProcessor can do whatever it wants in the process method, but ultimately needs to return an HTML or DocBook string to inject (whatever is appropriate for the current backend). To get that HTML or DocBook, it can run Asciidoctor on other source content.

Here's the link to the issue for allowing AsciiDoc content in docinfo files, btw:

https://github.com/asciidoctor/asciidoctor/issues/1240

There's also an example of a DocinfoProcessor linked in that issue.

Cheers,

-Dan

Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen