Projet Patacrep

Le projet Patacrep fournit des outils pour compiler un carnet de chants en LaTeX (en utilisant le paquet songs).

Les chansons sont écrites, au choix, en utilisant le langage chordpro (auquel cas elles seront converties en LaTeX lors de la compilation du carnet), ou en utilisant directement LaTeX.

Liens externes

Projets liés

patacrep

Le nom patacrep désigne à la fois l’ensemble du projet (un ensemble d’outils), et la bibliothèque au cœur du projet (l’outil principal, utilisé par les autres outils).

  • patacrep regroupe les projets décrits ci-après (patacrep, pataextra, patadata, patanet, patagui) et est un ensemble d’outils de manipulation de chants et de carnets de chants ;
  • patacrep/patacrep est la bibliothèque principale, qui fournit les outils principaux nécessaires à cette manipulation, ainsi qu’un outil en ligne de commande (songbook).

Pages de développement : organisation, patacrep.

patadata

Ce projet contient un grand nombre de chansons pouvant être manipulées par patacrep, ainsi que divers carnets de chants les rassemblant.

Page de développement

patanet

Une interface web est en cours de développement à l’heure où nous écrivons cette documentation. Elle permettra de créer des carnets de chants en utilisant les outils patacrep, dans un navigateur web.

Page de développement

Outils non maintenus

patagui

Une interface graphique a été développée pour une ancienne version de patacrep. Nous manquons malheureusement de temps pour la maintenir à jour. Elle devrait fonctionner avec la version 3.7.2 de patacrep, mais pas avec les suivantes.

Nous espérons que son développement reprendra dans le futur (par nous ou de nouveaux contributeurs), mais elle est pour le moment obsolète.

Page de développement

pataextra

Quelques outils pour manipuler les chansons sont disponibles dans ce projet. Malheureusement, ce projet est peu maintenu, les outils sont peu documentés, et peut-être obsolètes.

Page de développement

Outils externes

Voici quelques outils que l’utilisateur pourrait avoir à manipuler.

LaTeX

L’ensemble d’outils patacrep produit un fichier LaTeX, qui est compilé pour devenir un carnet de chants au format PDF. Les chansons peuvent êtres écrites en chordpro, mais il est possible d’utiliser directement LaTeX, auquel cas il pourra être utile de se familiariser avec cet outil, avec par exemple Une courte (?) introduction à LaTeX2e (original en anglais).

Songs

En particulier, le paquet songs (documentation en anglais) est utilisé pour rendre les chansons, et en particulier pour marquer les accords.

Les cas d’utilisation de base sont expliqués dans la section Écriture des chansons.

Lilypond

Il est possible d’intégrer des partitions aux chansons. Si ces partitions peuvent être intégrées comme des images (JPG, PNG, PDF) en utilisant la directive image, Lilypond permet de manipuler les partitions écrites au format Lilypond.

Plus d’informations dans la section Partitions, et sur le site du projet.

Python

Python est le langage de programmation utilisé pour écrire la majeure partie des outils de patacrep. S’il n’est pas nécessaire d’avoir entendu parler de ce langage pour créer un carnet de chant, c’est en Python que peuvent être écrites des extensions permettant d’inclure de nouveaux formats de contenu aux carnets de chant. Voir la section Ajouter du contenu aux carnet : écrire un plugin pour plus d’informations.

jinja2

Jinja2 est le moteur utilisé pour écrire les templates. Bien qu’écrit en Python, la connaissance de ce langage n’est nécessaire que pour des cas d’utilisation avancés.

L’utilisation pour les cas de base est décrite dans la section Changer la mise en page des carnets : le système des templates.