diff --git a/README.adoc b/README.adoc index 489ff51..35d9dc9 100644 --- a/README.adoc +++ b/README.adoc @@ -1,3 +1,7 @@ + +image::https://gravatar.com/avatar/88d204d546890e5d89073fb1cec29fe9.png?size=48[] +*celestino . amoroso @ gmail . com* + # Documentazione e procedure include::https://git.portale-stac.it/howto/linux/raw/branch/main/Desktop/README.adoc[] @@ -6,5 +10,5 @@ include::https://git.portale-stac.it/howto/linux/raw/branch/main/System/README.a include::https://git.portale-stac.it/howto/linux/raw/branch/main/SSH/README.adoc[] -include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/README.adoc[leveloffset=1] +include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/README.adoc[] diff --git a/Text/Markup/Asciidoctor/README.adoc b/Text/Markup/Asciidoctor/README.adoc index f1376e0..d68c342 100644 --- a/Text/Markup/Asciidoctor/README.adoc +++ b/Text/Markup/Asciidoctor/README.adoc @@ -1,3 +1,3 @@ ## Asciidoctor -* https://git.portale-stac.it/howto/linux/src/branch/main/Text/Markup/Asciidoctor/adoc_include_from_gitea.adocx[Inclusione di file come URL Gitea] +* https://git.portale-stac.it/howto/linux/src/branch/main/Text/Markup/Asciidoctor/adoc_include_from_gitea.adoc[Inclusione di file come URL Gitea] diff --git a/Text/Markup/Asciidoctor/adoc_include_from_gitea.adoc b/Text/Markup/Asciidoctor/adoc_include_from_gitea.adoc index 3a56121..e4161e0 100644 --- a/Text/Markup/Asciidoctor/adoc_include_from_gitea.adoc +++ b/Text/Markup/Asciidoctor/adoc_include_from_gitea.adoc @@ -1,25 +1,86 @@ -= rtcwake - Risveglio programmato di un PC Linux -Risveglio programmato di un PC Linux -:authors: Celestino Amoroso -:docinfo: shared -:encoding: utf-8 -:toc: right -:toclevels: 4 -:toc-title: Indice Generale -:icons: font -:icon-set: fi -:numbered: -:table-caption: Tabella -:figure-caption: Diagramma -:docinfo1: -:sectlinks: -:sectanchors: -:source-highlighter: rouge -// :rouge-style: ThankfulEyes -:rouge-style: gruvbox -// :rouge-style: colorful -//:rouge-style: monokay - -toc::[] - -#todo# += asciidoctor - Inclusione file da Gitea +Inclusione di file referenziati come URL Gitea +:authors: Celestino Amoroso +:docinfo: shared +:encoding: utf-8 +:toc: right +:toclevels: 4 +:toc-title: Indice Generale +:icons: font +:icon-set: fi +:numbered: +:table-caption: Tabella +:figure-caption: Diagramma +:docinfo1: +:sectlinks: +:sectanchors: +:source-highlighter: rouge +// :rouge-style: ThankfulEyes +:rouge-style: gruvbox +// :rouge-style: colorful +//:rouge-style: monokay + +toc::[] + +== Scopo +Questa guida spiega come includere in un documento Asciidoctor altri documenti che sono referenziati come URL Gitea. Ad esempio, + + https://git.portale-stac.it/howto/linux/src/branch/main/SSH/README.adoc + + +=== Inclusione file in Asciidoctor + +In generale, in un documento Asciidoctor l'inclusione di altri documenti si effettua con la direttiva `include::adoc-file-path-to-include[` _opzioni_ `]`. +Per ulteriori dettagli vedere https://docs.asciidoctor.org/asciidoc/latest/directives/include/[qui]. + +L'opzione _leveloffset_ consente di specificare in quale livello della struttura del documento principale dev'essere inserito il documento esterno. +Ad esempio: + + inlcude::section-01.adoc[leveloffset=+1] + +inserisce il documento importando le sue intestazioni con un livello più alto (interno) di quello in cui la direttiva `include::` è compresa (vedere https://docs.asciidoctor.org/asciidoc/latest/directives/include-with-leveloffset/[qui]). + +==== Inclusione di documenti referenziati come URL +Oltre all'inclusione di file provenienti dal filesystem locale, Asciidoctor può incorporare file specificati tramite URL. Esempio. + + include::http://www.mysite.com/docs/section-01.adoc[leveloffset=+1] + +==== Abilitazione inclusione URL +L'inclusione di documenti riferiti come URL è soggetta ad abilitazione esplicita (vedere https://docs.asciidoctor.org/asciidoc/latest/directives/include-uri/[qui]). L'abilitazione si esegue su riga di comando con l'attributo _-a allow-uri-read_. +Per includere URL quindi il comando `asciidoctor` dev'essere invocato come segue: + + asciidoctor -a allow-uri-read main.adoc + +==== Abilitazione inclusione URL in Gitea +Per attivare l'inclusione delle URL in Gitea arricchire il valore di _RENDER_COMMAND_ aggiungendo l'attributo _allow-uri-read_: + +.Sezione markup in gitea.ini +[source,ini] +---- +[markup.asciidoc] +ENABLED = true +FILE_EXTENSIONS = .adoc,.asciidoc +RENDER_COMMAND = "asciidoctor -s -a allow-uri-read -a 'newline=\n' -a lang=it -a showtitle --out-file=- -" +; Input is not a standard input but a file +IS_INPUT_FILE = false +---- + +Dopo la modifica, riavviare il servizio Gitea: + + sudo systemctl restart gitea + +==== Inclusione di documenti contenuti in Gitea +Le URL che refenziano documenti Gitea devono puntare ai file originali, non a quelli processati. Ad esempio, l'URL + + https://git.portale-stac.it/howto/linux/src/branch/main/SSH/README.adoc + +fa riferimento al file README.adoc contenuto nella directory SSH; il suo contenuto è preprocessato da Asciidoctor prima di essere ritornato al client/browser che lo richiede. +Tale contenuto è in formato HTML, non nella forma originale adoc. + +Per ottenere il contenuto originale (raw) del file bisogna sostiuire nel path la componente *_src_*, posta fra il nome del repository (`howto/linux`) e la componente `branch` con la componente *_raw_*. +Nell'esempio di sopra, il link raw è: + + https://git.portale-stac.it/howto/linux/raw/branch/main/SSH/README.adoc + + + diff --git a/Text/Markup/README.adoc b/Text/Markup/README.adoc index 8dc78cf..9e64af3 100644 --- a/Text/Markup/README.adoc +++ b/Text/Markup/README.adoc @@ -1,4 +1,4 @@ ## Markup -include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/Markup/Asciidoctor/README.adoc[leveloffset=2] +include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/Markup/Asciidoctor/README.adoc[leveloffset=+1] diff --git a/Text/README.adoc b/Text/README.adoc index 9c75a8d..180dc17 100644 --- a/Text/README.adoc +++ b/Text/README.adoc @@ -1,4 +1,4 @@ ## Text -include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/Markup/README.adoc[leveloffset=1] +include::https://git.portale-stac.it/howto/linux/raw/branch/main/Text/Markup/README.adoc[leveloffset=+1] diff --git a/template.adoc b/template.adoc index 7cf263a..74e2d46 100644 --- a/template.adoc +++ b/template.adoc @@ -1,31 +1,33 @@ -= template - Modello base di documento Asciidoctor -Sottotitolo documento -:authors: Celestino Amoroso -:docinfo: shared -:encoding: utf-8 -:toc: right -:toclevels: 4 -:toc-title: Indice Generale -:icons: font -:icon-set: fi -:numbered: -:table-caption: Tabella -:figure-caption: Diagramma -:docinfo1: -:sectlinks: -:sectanchors: -:source-highlighter: rouge -// :rouge-style: ThankfulEyes -:rouge-style: gruvbox -// :rouge-style: colorful -//:rouge-style: monokay - -toc::[] - -## Titolo di capitolo -#testo capitolo# - -### Titolo di sezione - -#testo di sezione# - += template - Modello base di documento Asciidoctor +Sottotitolo documento +:authors: Celestino Amoroso +:docinfo: shared +:encoding: utf-8 +:toc: right +:toclevels: 4 +:toc-title: Indice Generale +:icons: font +:icon-set: fi +:numbered: +:table-caption: Tabella +:figure-caption: Diagramma +:docinfo1: +:sectlinks: +:sectanchors: +:source-highlighter: rouge +// :rouge-style: ThankfulEyes +:rouge-style: gruvbox +// :rouge-style: colorful +//:rouge-style: monokay + +toc::[] + +### Titolo di sezione + +#testo di sezione# + +''' +*Celestino Amoroso* + +*celestino . amoroso @ gmail . com* + +image::https://gravatar.com/avatar/88d204d546890e5d89073fb1cec29fe9.png?size=48[]