diff options
Diffstat (limited to 'Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex')
| -rw-r--r-- | Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex | 277 |
1 files changed, 188 insertions, 89 deletions
diff --git a/Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex b/Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex index 7028d6dfe18..cd34e01dfd0 100644 --- a/Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex +++ b/Master/texmf-dist/doc/xelatex/facture-belge-simple-sans-tva/facture-belge-simple-sans-tva-doc.tex @@ -31,6 +31,7 @@ %\usepackage{makeidx} %\usepackage{multirow} %\usepackage{graphicx} +\usepackage{calctab} \author{\textsc{Sebille} Robert} \date{\today} @@ -61,8 +62,12 @@ frame=single, Documentation de l'extension \og Facture belge simple sans \textsc{TVA} \fg. L'extension comprend deux modèles: article-facture.tex .tex \& article-note-de-frais.tex. \end{abstract} -\section*{Généralités} -\subsection*{La déclaration \textbackslash usepackage[Arg]\{facture-belge-simple-sans-tva\}} + +\tableofcontents +\newpage + +\section{Généralités} +\subsection{La déclaration \textbackslash usepackage[Arg]\{facture-belge-simple-sans-tva\}} \begin{lstlisting} La déclaration \usepackage[Arg]{facture-belge-simple-sans-tva} doit comporter au moins 1 argument [Arg] de langue pour babel: french, english, etc. @@ -85,7 +90,7 @@ Exemples d'options pour \textbackslash usepackage[Arg]\{facture-belge-simple-san \usepackage[french]{facture-belge-simple-sans-tva} \end{lstlisting} -\subsection*{Quelques unités monétaires courantes}% +\subsection{Quelques unités monétaires courantes}% \label{sub:unites_monetaire_courantes} Attention, le symbole \euro{} exige le package \textbackslash usepackage\{eurosym\}.% @@ -106,7 +111,7 @@ Yen japonais & \textbackslash textyen\{\} & \textyen{} \\% \end{tabular}% \end{center}% -\subsection*{Les unités de longueurs}% +\subsection{Les unités de longueurs}% \label{sub:unites_longueurs} \begin{center}% @@ -130,7 +135,7 @@ pouce & in & 2,54 cm \\% \end{center}% -\subsection*{Les abréviations de civilités}% +\subsection{Les abréviations de civilités}% \label{sub:abreviations_civilites} \begin{center}% @@ -158,7 +163,7 @@ messieurs & MM. & MM.\\% \end{center}% -\subsection*{\'{E}crire les nombres en lettres en typographie française}% +\subsection{\'{E}crire les nombres en lettres en typographie française}% \label{sub:ecrire_nombres_en_lettres} Ce résumé est entièrement tiré de l'article \og \href{https://www.francaisfacile.com/exercices/exercice-francais-2/exercice-francais-53446.php}{ÉCRIRE LES NOMBRES EN LETTRES} \fg\ du site \href{https://www.francaisfacile.com/}{Francaisfacile.com}. Veuillez consulter ce site pour toute information complémentaire. @@ -191,7 +196,7 @@ Ce résumé est entièrement tiré de l'article \og \href{https://www.francaisfa \end{itemize} \end{itemize} -\section*{Résultats des commandes:} +\section{Résultats des commandes:} Veuillez vous référer aux résultats des modèles article-facture.tex \& article-note-de-frais.tex \begin{description} \item [la facture:] article-facture.pdf; @@ -199,18 +204,22 @@ Veuillez vous référer aux résultats des modèles article-facture.tex \& artic \end{description} -\section*{Variables disponibles} +\section{Variables disponibles} Les noms parlent d'eux-mêmes. -\subsection*{Communes facture \& note de frais} +\subsection{Communes facture \& note de frais} \begin{lstlisting} \rsEncodage -\rsuniteMonetaire \rsespaceVertical +\rsuniteMonetaire +% \rsuniteMonetaire est disponible dans la facture mais non +% utilisée par le modèle; l'unité monétaire du tableau des produits +% de la facture est fixé par \ctcurrency{<\unité>} et non disponible +% dans la facture sous cette forme \end{lstlisting} -\subsection*{Note de frais seulement} +\subsection{Note de frais seulement} \begin{lstlisting} \rsprenomNomCreancier \rssocieteCreancier @@ -233,7 +242,7 @@ Les noms parlent d'eux-mêmes. \rstotalEnLettres \end{lstlisting} -\subsection*{Système} +\subsection{Système} \begin{lstlisting} \rsvarname \rsvarversion @@ -242,7 +251,7 @@ Les noms parlent d'eux-mêmes. \end{lstlisting} -\section*{Commandes} +\section{Commandes} Vous aurez peut~être remarqué que toutes les commandes et variables débutent par \textbackslash rs\dots @@ -255,7 +264,7 @@ Il y a en effet vraiment peu de chance qu'une commande \LaTeX{} commence un jour un \textbackslash rs\dots, comme dans \og \emph{r}obert \emph{s}ebille \fg. -\subsection*{Communes à la facture \& à la note de frais} +\subsection{Communes à la facture \& à la note de frais} \emph{Vérifier l'encodage UTF-8 ou latin1:} \begin{lstlisting} @@ -271,11 +280,18 @@ mais vous pouvez aussi choisir une des unités courantes reprises dans cette sou \begin{lstlisting} % Autres unités courantes: \$ \pounds \textyen +%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Rappel pour la facture: %% +% \rsuniteMonetaire est disponible dans la facture mais non +% utilisée par le modèle; l'unité monétaire du tableau des produits +% de la facture est fixé par \ctcurrency{<\unité>} et non disponible +% dans la facture sous cette forme \end{lstlisting} \emph{Aérer la page verticalement:} \begin{lstlisting} -% L'aération verticale est fixée à 1cm par défaut: +% L'aération verticale est fixée par défaut à 0.5cm pour la facture +% et à 1cm pour la note de frais: \rsAerationVerticale{1cm} \end{lstlisting} mais vous pouvez aussi choisir une des unités de longueur reprises dans cette sous-section de la page \pageref{sub:unites_longueurs}. @@ -305,7 +321,7 @@ ceci n'est bien sur pas une commande, mais un texte libre à placer à un endroi \end{lstlisting} -\subsection*{Pour la facture seulement} +\subsection{Pour la facture seulement} \emph{Numéro et date de la facture:} \begin{lstlisting} @@ -313,7 +329,7 @@ ceci n'est bien sur pas une commande, mais un texte libre à placer à un endroi \end{lstlisting} où \emph{X} est un nombre représentant le n\up{o} de la facture et \emph{JJ mois AAAA} une chaîne de caractères représentant la date. -\subsubsection*{Tableau des adresses: expédition, facturation, livraison} +\subsubsection{Tableau des adresses: expédition, facturation, livraison} \emph{On ouvre l'entête du tableau des adresses:} \begin{lstlisting} @@ -401,47 +417,108 @@ qui ne donne évidemment, tel quel, aucun résultat. \rsPiedTableauAdresses{} \end{lstlisting} +\subsubsection{Tableau des produits, avec le package calctab} -\subsubsection*{Tableau des produits: quantité, prix, remise, total produit} - -\emph{On ouvre l'entête du tableau des produits:} +On ne va pas réinventer le monde, mais simplement réutiliser les commandes +simples et efficaces du package calctab, dans son environnement xcalctab. +\\ +Les entêtes de tableau de calctab sont en anglais par défaut, + nous en avons besoin en français; ainsi qu'une préposition apparaissant dans les remises (ou la taxes): \og on \fg\ en anglais, \og sur \fg\ en français. + \begin{lstlisting} -% À n'utiliser qu'une seule fois; -% on sera bien avisé de ne pas toucher à cette commande; -% et surtout au % qui la suit. -\rsEnteteTableauProduits{}% Ce commentaire bloque un blanc indésirable. -% ATTENTION: retirer le commentaire ci-dessus déstabilise l'affichage! +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% D'abord quelques paramètres utiles pour nous: +%% On fixe les headers en français (anglais par défaut) +%% \ctcurrency{\euro}, la monnaie est fixée plus haut +%% près du point "Unité monétaire" +\ctdescription{Nature} +\ctontraslation{sur} +\ctheaderone{Quantité} +\ctheadertwo{Prix unit.} +%% Par défaut 2 décimales, c'est plutôt correct, non? +\nprounddigits{2} \end{lstlisting} -\emph{Entrée d'une ligne de produit:} -Ordre des arguments: produit, quantité, prix, remise, total produit. +Dans la foulée, on crée le tableau des produits; les explications sont simples, représentées ci-dessous et dans le modèle article-facture.tex. Vous pouvez bien sûr lire les instructions calctab et ajouter des commandes, mais il y a peu de chance de l'avis des conseillers du mainteneur que ce soit nécessaire \ldots + +%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%% Ensuite le tableau des produits avec nature, quantité, coût et éventuelles +%% remises \begin{lstlisting} -%% Les calculs arithmétiques sont à votre charge !! -%% Ordre des arguments: -%% \rsLigneTableauProduits{produit}{quantité}{prix}{remise}{total produit} -%% par exemple: -\rsLigneTableauProduits{Produit 1}{5}{100,00}{0,00}{500,00} -\rsLigneTableauProduits{Produit eget luctus nisl}{2}{1.000,00}{0,00}{2.000,00} -\end{lstlisting} +% On ouvre l'environnement xcalctab +\begin{xcalctab} +%% calctab est en police police sans empattements (sf, pour sans serif), +%% on remet en normalfont de ce document +\normalfont +%% On ajoute des produits +% \amount{nature}{quantité}{prix unitaire} +%% si amount comporte un id comme ci-dessous, on pourra lui appliquer une remise (-) (ou une taxe (+)) +%% avec la commande \perc[identificateur]{Intitulé}{+/-pourcentage} +%% une id s'écrit ainsi: [id=identificateur] identificateur = 1 seul mot entier! +% \amount[id=identificateur]{nature}{quantité}{prix unitaire} +%% Simple, non? -\emph{Entrée de la ligne du total général:} -A terminer obligatoirement par la ligne du total général. +% produits (avec ou sans id) +\amount{Produit 1}{5}{100,0} +\amount[id=eget]{Produit eget luctus nisl}{2}{1000,0} -\begin{lstlisting} -%% \rsLigneTotalTableauProduits{total produit} -\rsLigneTotalTableauProduits{2.500,00} +% Remise: on va mettre -10% sur "Produit eget luctus nisl" +\perc[eget]{Remise généreuse de}{-10} + +% Grand total: +\add{Total} + +% On ferme l'environnement xcalctab +\end{xcalctab} \end{lstlisting} -\emph{On ferme le pied du tableau des produits:} +\paragraph{Et ci-dessous, le résultat:} le tableau des produits, avec le package calctab. + +\emph{Les totaux sont calculés automatiquement!} + +\ctcurrency{\euro} +\ctdescription{Nature} +\ctontraslation{sur} +\ctheaderone{Quantité} +\ctheadertwo{Prix unit.} + + +\begin{xcalctab} +\normalfont +\amount{Produit 1}{5}{100,0} +\amount[id=eget]{Produit eget luctus nisl}{2}{1000,0} +\perc[eget]{Remise généreuse de}{-10} +\add{Total} +\end{xcalctab} + + +\subsubsection{Un texte libre sous le tableau des produits} + +Par exemple \ldots + \begin{lstlisting} -% À n'utiliser qu'une seule fois; -% on sera bien avisé de ne pas toucher à cette commande. -\rsPiedTableauProduits{} +%%%%%%%%%%%%%%%%%%%%%%%%% +%% Texte libre, DEBUT. %% +%%%%%%%%%%%%%%%%%%%%%%%%% + +\paragraph*{Description du produit:} + Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla rhoncus est ac viverra lacinia. Etiam pulvinar tempus rutrum. Maecenas vel metus metus. + +\paragraph*{\'{E}tendue des fournitures:} +\begin{itemize} + \item La livraison du produit 1 s'étend sur 5 semaines, du JJ/MM/AAAA au JJ/MM/AAAA, 1 quantité par semaine; + \item La livraison du produit eget luctus nisl s'étend sur 2 mois, du JJ/MM/AAAA au JJ/MM/AAAA, 1 quantité par semaine. +\end{itemize} + +%%%%%%%%%%%%%%%%%%%%%%% +%% Texte libre, FIN. %% +%%%%%%%%%%%%%%%%%%%%%%% \end{lstlisting} -\emph{Entrée du compte bancaire créditeur et de la date limite de paiement:} +\subsubsection{Entrée du compte bancaire créditeur et de la date limite de paiement:} + \begin{lstlisting} \rsCompteBancaireEtDateLimiteDePaiement{BEXX XXXX XXXX XXXX}{JJ mois AAAA} \end{lstlisting} @@ -449,50 +526,49 @@ ou \emph{BEXX XXXX XXXX XXXX} est une chaîne de caractères représentant le n\ -\subsection*{Pour la note de frais seulement} +\subsection{Pour la note de frais seulement} -\paragraph*{Attention:} Les calculs arithméthiques sont à la charge du rédacteur de la note. +\paragraph{Notez bien:} \emph{Le total des frais à rembourser --- le seul, est également calculé automatiquement!} -\subsubsection*{Récolte des informations nécessaires} +\subsubsection{Récolte des informations nécessaires} \emph{Le créancier:} qui entre la note: Seuls les champs non vides seront pris en considération. \begin{lstlisting} -% identification créancier: prenom nom, societe. Exemple: +%% créancier (qui entre la note de frais) +%% prenom nom societe \rsIdentificationCreancier{Jules \textsc{Creancier}}{asbl \textsc{La Créance}} -% adresse créancier: rue no, codpost ville, pays, email, téléphone. Exemple: +%% adresse créancier {rue no}{codpost ville}{pays}{email}{téléphone} +%% format email: \href{mailto:user@domain.tld}{user@domain.tld} \rsAdresseCreancier{52, rue Delarue}{4321 \textsc{Brux-aile}}{\textsc{Belgique}}{\href{mailto:user@domain.tld}{user@domain.tld}}{+32 2 123 45 67} -% Notez le format email: \href{mailto:user@domain.tld}{user@domain.tld} -% Qui peut aussi servir pour des sites: \href{http://www.domain.tld}{My domain} -% Ces liens fonctionneront dans la plupart des lecteurs de pdf. \end{lstlisting} \emph{Le client:} qui paie la note. Pour la documentation de la typographie française des civilités, voyez cette sous-section p. \pageref{sub:abreviations_civilites}. Seuls les champs non vides seront pris en considération. \begin{lstlisting} -% NB: l'ajout du champ civilité. -% identification client: Prenom Nom, societe, civilite. Exemple: +%% client (qui paye la note de frais) +%% Prenom Nom, societe, civilite +%% typographie française des civilités, voir la documentation +%% facture-belge-simple-sans-tva-doc.pdf \rsIdentificationClient{Léon \textsc{Client}}{\textsc{SA La Cliance}}{M. } -% adresse client: rue no, codpost ville, pays. Exemple: +% adresse client {rue no}{codpost ville}{pays} \rsAdresseClient{DelarueStraat 25}{4321 \textsc{Brux-aile}}{\textsc{Belgique}} \end{lstlisting} \emph{Autres informations:} \begin{lstlisting} -% mois annee note de frais, pour le sous-titre +%% mois annee note de frais \rsMoisAnneeNote{octobre 1952} -% Numéro de compte créancier (IBAN), totaux en chiffres et en lettres, en réserve pour après +%% numéro de compte créancier (IBAN) \rsCompteEnBanqueCreancier{BE01 1234 5678 9012} -\rsTotalEnChiffres{26,25} -\rsTotalEnLettres{vingt-six euros virgule ving-cing} \end{lstlisting} -\subsubsection*{Constructeurs} +\subsubsection{Constructeurs} Et maintenant, on commnence à construire le document note de frais à l'aide de 3 constructeurs, dans l'ordre, et dont les noms parlent d'eux-mêmes: \begin{lstlisting} \rsConstruitAdresseCreancier{} @@ -501,7 +577,51 @@ Et maintenant, on commnence à construire le document note de frais à l'aide de \end{lstlisting} -\subsubsection*{Texte libre} +\subsubsection{Tableau des items à rembourser} + +La documentation ci-dessous est reprise \og telle quelle \fg\ dans le modèle \og article-note-de-frais.tex \fg. + + +\begin{lstlisting} +%% On ouvre l'entête du tableau des items à rembourser; à n'utiliser qu'une seule fois. +\rsEnteteTableauItemsARembourser{}% Ce commentaire bloque un blanc indésirable. +%% ATTENTION: retirer le commentaire ci-dessus déstabilisera l'affichage !!! + +%% Entrée de lignes d'items à rembourser, dans l'ordre +%% no piece, date, nature, montant ttc, moyen de paiement. +%% le total en chiffre est calculé automatiquement +%% les montants DOIVENT être en cents: 10€25 = 1025 +%% \rsLigneTableauItemsARembourser{numero}{JJ/MM/AAAA}{Nature}{Montant TTC en cents}{Moyen} + +\rsLigneTableauItemsARembourser{1}{04/10/1952}{Gateau d'anniversaire}{2520}{Carte bancaire} +\rsLigneTableauItemsARembourser{2}{04/10/1952}{Bougie d'anniversaire}{500}{Carte bancaire} +\rsLigneTableauItemsARembourser{3}{06/10/1952}{Bicarbonate de soude}{125}{Espèces} + + +%% On ferme le pied du tableau des items à rembourser; le total des frais sera calculé +%% automatiquement; à n'utiliser qu'une seule fois. +\rsPiedTableauItemsARembourser{} +\end{lstlisting} + +\subsubsection{Vérification en chiffres en lettres} + + +A propos des totaux: \textbackslash rsTotalEnChiffres sera construit automatiquement, mais, notez bien +\begin{enumerate} + \item qu'il est impossible de placer la variable \textbackslash rstotalEnChiffres{} avant le tableau des items à rembourser, car elle est construite dynamiquement en même temps que ce tableau pour obtenir le total chiffres; + \item si vous souhaitez un total en lettres, il s'agit d'un affichage, vous devez l'écrire vous même, avec \textbackslash rsTotalEnLettres\{montant en lettres\}. +\end{enumerate} + +Alors, \emph{attention qu'il corresponde au total en chiffres, automatiquement calculé}. Ceci est de votre responsabilité de vérifier et d'écrire le montant correct. Voici, ci-dessous, un outil qui vous aidera; pour le faire apparaître disparaître, il suffit de le dé commenter. + +\begin{lstlisting} +\rsTotalEnLettres{trente et un euros virgule quarante-cinq} +%% Décommenter pour vérifier les correspondances chiffres - lettres, commentez pour me cacher. +\textbf{\begin{center} Vérifiez chiffres = lettres, puis commentez-moi pour me faire disparaître\\ \rstotalEnChiffres{}~\rsuniteMonetaire{} = \rstotalEnLettres{} \end{center}} +\end{lstlisting} + + +\subsubsection{Texte libre} S'ensuit un texte libre, par défaut, ceci: \begin{lstlisting} @@ -521,32 +641,7 @@ Je soussigné, \rsprenomNomCreancier{}, déclare qu'il m'est dû par \rscivilite \end{lstlisting} -\subsubsection*{Tableau des items à rembourser} -Et donc, le tableau annoncé. - - -\begin{lstlisting} -% On ouvre l'entête du tableau des items à rembourser; à n'utiliser qu'une seule fois. -\rsEnteteTableauItemsARembourser{}% Ce commentaire bloque un blanc indésirable. -% ATTENTION: retirer le commentaire ci-dessus déstabilisera l'affichage !!! - -% puis entrée de lignes d'items à rembourser, dans l'ordre -% no piece, date, nature, montant ttc, moyen de paiement. -% les calculs sont à votre charge. -% \rsLigneTableauItemsARembourser{numero}{JJ/MM/AAAA}{Nature}{Montant TTC}{Moyen}. Exemple: -\rsLigneTableauItemsARembourser{1}{04/10/1952}{Gateau d'anniversaire}{25,00}{Carte bancaire} -\rsLigneTableauItemsARembourser{2}{04/10/1952}{Bougie d'anniversaire}{5,00}{Carte bancaire} -\rsLigneTableauItemsARembourser{3}{06/10/1952}{Bicarbonate de soude}{1,25}{Espèces} - -% A terminer obligatoirement par la ligne du total général des items à rembourser -% \rsLigneTotalTableauItemsARembourser{total_items_a_rembourser}. Exemple: -\rsLigneTotalTableauItemsARembourser{26,25} - -% Enfin, on ferme le pied du tableau des items à rembourser; à n'utiliser qu'une seule fois. -\rsPiedTableauItemsARembourser{} -\end{lstlisting} - -\subsubsection*{Injonction à payer} +\subsubsection{Injonction à payer} Maintenant, on enjoint à payer avec un 4\up{e} constructeur, qui présente une \og grosse \fg\ subtilité possible. \begin{lstlisting} @@ -561,8 +656,7 @@ C'est le 3\up{e} argument qui propose une astuce utile. En effet, certains clients, par facilité administrative et dans une relation de confiance avec le créancier, acceptent l'usage d'une signature \og image \fg\ en lieu et place d'une signature écrite. Si le 3\up{e} parametre = oui \emph{et} qu'un fichier signature.png existe dans le répertoire courant, il sera affiché en tant que signature, sinon la place sera pour une signature manuscrite. -\subsubsection*{Texte libre} -On termine avec un 2\up{e} texte libre, ici, en l'occurence et par défaut: +\subsubsection{Texte libre} \begin{lstlisting} %%%%%%%%%%%%%%%%%%%%%%%%% @@ -576,4 +670,9 @@ Les pièces justificatives, numérotées suivant le tableau, sont jointes à la %%%%%%%%%%%%%%%%%%%%%%% \end{lstlisting} +\hrule + +\paragraph*{Remarques:} Si vous avez des commentaires, des remarques, + ou des erreurs à signaler dans cette documentation, vous pouvez \href{https://gitlab.adullact.net/zenjo/facture-belge-simple-sans-tva/issues}{les signaler ici}. + \end{document} |