How to use Asciidoctor themes? [solved]

[fsa1803]

Hello. I would like to insert some text in the header and at the footer of the pages. In the asciidoc documentation I see that we need to create an external theme file. Is it possible or is there another method?

Thanks

[divinity666]

To do so, you need to use the provided asciidoctor capabilities. So creating external theme files, as described here* Create the external themes as described here, is the way to go. Here are some short descriptions for different use cases:

1) Reporter with fixed setting of pdf-theme

• Specify necessary variables (pdf-theme, pdf-themesdir and optionally pdf-fontsdir) in your configuration file in the default-document-attributes section, e.g.

  default-document-attributes:
  pdf-theme: <<your_theme_name>>
  pdf-themesdir: <<path_to_your_themes>>

• Restart the report webservice, if applicable, or run the reporter command standalone from command line

If everything is setup properly, your style theme should be applied for the next renderings.

2) Reporter call from command line

• Add the command line options pdf-theme and pdf-themesdir to your command line call, e.g.

  ruby-grafana-reporter -t <<your_template>> -s pdf-theme,<<your_theme_name>> -s pdf-themesdir,<<path_to_your_themes>>

3) Reporter call as webservice

• Add the parameters pdf-theme and pdf-themesdir to your calling url, e.g.

  http://localhost/render?var-template=<<your_template>>&pdf-theme=<<your_theme_name>>&pdf-themesdir=<<path_to_your_themes>>

Hope this helps.

[fsa1803]

Thanks for your tips, everything works. Attributes cannot be placed in the adoc file, but that's not a problem for me, I use an external theme. But I think that being able to insert the attributes in the adoc file is a nice evolution.

Thanks