planfacile - En ligne dans le Cloud

PROGRAMME:

Nom

planfacile - Un compilateur de documents.

SYNOPSIS

planfacile [options] [fichiers]

DESCRIPTION

PlanFacile est un compilateur de documents, conçu pour le calcul de la table des matières. Suite
précisément, PlanFacile considère qu'un document est un ensemble de concepts liés par
dépendances. PlanFacile génère un document en utilisant ces idées, trié afin de lire
du début à la fin avec un minimum de références croisées à d'autres parties de
le document.

PlanFacile génère uniquement des documents non formatés, tels que des sources HTML ou LaTeX.

BASIQUE GRAMMAIRE

Pour une utilisation courante de PlanFacile, il n'est pas nécessaire de connaître toute la langue de
PlanFacile. Le but de cette section est de présenter le minimum nécessaire pour savoir comment
rédiger un document.

Documents
Idées Un document, comme dit précédemment, est un ensemble d'idées que l'auteur veut communiquer au
lecteur. Une idée est une partie du document qui peut être représentée par un titre. Pour
exemple, si l'auteur constate qu'un titre ne représente pas fidèlement le texte de la
même idée, il doit juste s'assurer que deux concepts ne sont pas mis en un #idée commander...
La syntaxe d'une idée est assez simple :

#idée{référence}titre#texte

texte

#end

De plus, certaines idées sont dépendantes dans un document, elles sont donc liées par des dépendances (voir
paragraphe Dépendances).

Automatique et idées cadeaux Parfois, PlanFacile ajoute une idée au document. Dans ce cas, le
Writer peut remplacer le texte par défaut par une idée qui convient au document. Pour ce faire, il
sont deux commandes, qui sont comme #idée :

#disparu{indice}{référence}titre#texte

texte

#end

L'exposition indice paramètre est donné par PlanFacile, dans le message par défaut...

De la même manière :

#générique{mère référence}{référence}titre#texte

texte

#end

Dépendances Dans un document avec des idées sur le même sujet, il est tout à fait naturel que
les idées ont besoin que certaines des autres soient comprises par le lecteur. Cette relation est une
dépendance entre les idées.

Si l'écrivain met une dépendance dans le texte de l'idée A à l'idée B, cela signifie que le
le lecteur devra comprendre l'idée B avant de lire l'idée A afin de comprendre cela
dernière idée.

La syntaxe d'une dépendance, dans sa forme la plus simple, est :

#dép{référence}{#depref}{}

Cependant, le rédacteur peut avoir besoin d'ajouter un nombre positif pour spécifier la pondération du
dépendance si l'organisation du document n'est pas la bonne, même si le rédacteur
a mis les bonnes dépendances :

#dép{pertinence}{référence}{#depref}{}

L'exposition référence doit être l'un des mots utilisés dans le #idée commander.

Complété source code
Les idées ne sont pas suffisantes pour produire un document. Pour compléter un code source, le rédacteur
doit en apprendre un peu plus sur la langue de PlanFacile.

Standard La première commande de la source peut être #la norme, qui indique à PlanFacile à
charger des définitions standard, pour pouvoir produire un document en LaTeX ou en HTML (plus
formats seront présents à l'avenir).

Options et macros Lorsque l'écrivain utilise la commande #la norme, le compilateur pourra
pour générer tous les formats. L'écrivain doit indiquer son choix avec quelques commandes.

Un choix, comme le format de sortie, peut être paramétré avec une option :

#option{nom d'option}

et un paramètre de texte peut être défini avec une macro, pour un usage très spécifique :

#définir{le nom du paramètre}{valeur}

OPTIONS

PlanFacile utilise 36 options pour modifier son comportement. Énumérer tout cela ici n'est pas
intéressant, comme le -h option donne de l'aide sur toutes les options.

Certaines options sont souvent utiles :

-o sortie filet spécifier le fichier de sortie, pour écrire le document ;

-O option définir une option de compilateur, comme le #option commander. Ensuite, l'utilisateur a le
possibilité de régler certains paramètres au moment de la compilation ;

-d ignorer les dépendances invalides. Utile lorsque l'écrivain veut compiler une partie d'un
document, pour vérifier si cette partie est sans erreur ;

-A ignorer les idées automatiques non définies. Parfois, PlanFacile ajoute quelques idées pour compléter le
document. Cette option évite une erreur lorsqu'une idée automatique apparaît.

Utiliser planfacile en ligne en utilisant les services onworks.net