How can I use asciidoc conf file

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
5 messages Options
Reply | Threaded
Open this post in threaded view
|

How can I use asciidoc conf file

ch007m
Hi,

Ascidoc command line instruction allows/supports to provide location of the asciidoc conf file. Can we do that with asciidoctor ?

Asciidoc example --> asciidoc -f common/conf/html5.conf -b html5

Cheers,

Charles
Charles Moulliard
Apache Committer / Technologist Evangelist / Blogger / MiddleWare Specialist
Twitter : @cmoulliard
Reply | Threaded
Open this post in threaded view
|

Re: How can I use asciidoc conf file

mojavelinux
Administrator
The asciidoc.conf file is not supported in Asciidoctor. We've taken a more flexible, API-driven approach to customization and extensions in Asciidoctor. There are still some gaps to fill, but we've got coverage of the most important two features: templates and extension points.

What are you looking to configure?

-Dan


On Mon, Nov 18, 2013 at 2:15 AM, ch007m [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Hi,

Ascidoc command line instruction allows/supports to provide location of the asciidoc conf file. Can we do that with asciidoctor ?

Asciidoc example --> asciidoc -f common/conf/html5.conf -b html5

Cheers,

Charles


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/How-can-I-use-asciidoc-conf-file-tp1005.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: How can I use asciidoc conf file

ch007m
The html5.conf file used by RedHat GPE Training team contains a banner.html and footer.html which is included by asciidoc during rendering process of each asciidoc file (see end of the gist file where you will see include::../banner.html and include::../footer.html)

By example, Banner.txt (=asciidoc) corresponds to the following syntax :

:data-uri:

image::../common/images/rhheader.png[width=1024,height=152,align="center"]

Charles Moulliard
Apache Committer / Technologist Evangelist / Blogger / MiddleWare Specialist
Twitter : @cmoulliard
Reply | Threaded
Open this post in threaded view
|

Re: How can I use asciidoc conf file

mojavelinux
Administrator
In order to include custom header and footer HTML, you need to override the document template. You can do this by

1. Grabbing one of the document templates from the asciidoctor-backends repository:

2. Save the file to a custom backends directory of your choice

3. Modifying the template however you want

4. Specifying the location of the custom backends directory when you run Asciidoctor

asciidoctor -T /path/to/backends file.adoc

If calling Asciidoctor via the API, use the option :templates_dir => '/path/to/backends'

Note that you can also use the docinfo footer file to include custom HTML, but you are limited to where Asciidoctor places it by default (unless you also modify the document template).

-Dan


On Mon, Nov 18, 2013 at 3:51 AM, ch007m [via Asciidoctor :: Discussion] <[hidden email]> wrote:
The html5.conf file used by RedHat GPE Training team contains a banner.html and footer.html which is included by asciidoc during rendering process of each asciidoc file (see end of the gist file where you will see include::../banner.html and include::../footer.html)

By example, Banner.txt (=asciidoc) corresponds to the following syntax :

:data-uri:

image::../common/images/rhheader.png[width=1024,height=152,align="center"]




If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/How-can-I-use-asciidoc-conf-file-tp1005p1007.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Reply | Threaded
Open this post in threaded view
|

Re: How can I use asciidoc conf file

ch007m
This is finally what I have done. Customising the backend file (HTML5 HAML file).
Charles Moulliard
Apache Committer / Technologist Evangelist / Blogger / MiddleWare Specialist
Twitter : @cmoulliard