Questo repository contiene la nostra collezione di filtri pandoc. Qui troverete una breve descrizione per ciascun filtro.
Un filtro pandoc è un file che contiene istruzioni per modificare un
documento, come una macro di Office. I filtri possono essere scritti
in qualsiasi linguaggio di programmazione ed applicati a documenti
scritti in un qualsiasi formato supportato da pandoc come .rst
,
.docx
, .odt
, .html
, .markdown
.
Consideriamo il filtro filtro-acronimi
, che applica i consigli della
Guida al linguaggio della Pubblica
Amministrazione
modificando gli acronimi in un documento. Non è necessario essere un
programmatore per capire la logica seguita da questo
filtro, che può essere applicato ad un
documento così:
$ pandoc --filter filtro-acronimi da-filtrare.rst -o filtrato.rst
Nel documento filtrato.rst
gli acronimi per Anas e Anpr saranno
tutti corretti. Un filtro è quindi un modo semplice e potente di
modificare un documento. Inoltre un filtro è un programma molto
portabile, cioè facile da scambiare con i colleghi di altri uffici.
Alcuni
dei filtri qui contenuti possono essere installati sul vostro sistema
tramite
stack
e git
nei seguenti passi:
$ git clone https://github.com/italia/docs-italia-pandoc-filters.git
$ cd docs-italia-pandoc-filters
$ stack install
Nel caso generale non è necessario installare questi filtri, ma lo
diventa nel caso in cui vogliate usare il comando converti
che fa
parte del nostro set di comandi di
conversione
Copyright (c) the respective contributors, as shown by the AUTHORS file.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.