Ogígia

PCAL és un programa de generació de calendaris que produeixen una sortida PostScript (un avantpassat del pdf, per entendre’ns) senzills i nets.¹

PCAL s’utilitza normalment per generar calendaris en format mensual (un mes per pàgina) amb text i imatges incrustades opcionals per marcar esdeveniments especials (per exemple, vacances, aniversaris, etc.). També pot generar calendaris de format anual (un any per pàgina).

Va ser publicat per Andrew W. Rogers, la pàgina web del qual ha desaparegut. El desenvolupament d’aquesta utilitat es va detenir en la versió 4.11.0 l’any 2011.

A partir d’un fitxer de text pla (que podem crear amb el nostre editor de text preferit, és a dir, amb Emacs), on indicarem els dies festius i altres esdeveniments, Pcal genera un fitxer PDF (o PostScript) amb el calendari generat. Aquest fitxer es pot visualitzar en pantalla i es pot imprimir.

Pcal és un programa de terminal; per tant, l’haurem d’executar des de la línia d’ordres per a obtenir-ne el resultat final en PDF.

Dissortadament, Pcal és un programa tant antic que no treballa amb UTF-8. Això vol dir que, si desitgeu un calendari amb una llengua que no siga l’anglés, us caldrà tenir en compte un parell de detalls sobre la codificació del fitxer original (en cas contrari, les lletres modificades, com ara vocals accentuades o ce trencada, no es visualitzaran correctament).

Sol formar part dels repositoris de totes les distribucions GNU/Linux, de manera que es pot instal·lar amb el procediment habitual de cadascuna. Per exemple, en les distros de la família Debian, seria suficient amb:

sudo apt-get install pcal

Tanmateix, també el podeu descarregar directament de la web oficial de Pcal.

Imaginem que volem crear un calendari amb les festivitats dels Països Catalans; un punt de partida podria ser un fitxer de text pla amb el següent text:

opt -C "Calendari dels Països Catalans" 


year all
1/1*          Cap d'any
6/1*          Reis

1/3	      Dia de les Illes Balears
14/3*	      Dia de la Constitució (And)
19/3*	      Sant Josep

Easter*	       Pasqua de Ressurrecció
Good_Friday*   Divendres Sant
1st Monday after Easter*    Dilluns de Pasqua
2nd Monday after Easter*   Sant Vicent Ferrer
50rd Day after Easter*	Pentecosta

23/4	       Sant Jordi

24/6*          Sant Joan

1/5*	       Dia del Treball

15/8*	       Assumpció

11/9*	       Diada de Catalunya

9/10*	       Diada del País Valencià
12/10*         Mare de Déu del Pilar

1/11*          Tots Sants

8/12*          Immaculada Concepció
Christmas*     Nadal

26/12*         Sant Esteve

28/12          Dia dels Innocents

Així, imaginem que desem el codi anterior en un fitxer de text pla anomenat any-2023-PPCC.calendari. Com s’indica al text de l’exemple, cal desar el fitxer amb codificació Latin1 o ISO-8859-15 (tots els editors decents permeten fer-ho). Ara, per generar-ne el PDF, obrirem un terminal, anirem al directori on l’havíem desat i escriurem:

pcal -r Latin1 -a ca -P a4 -F1 -B -f any-2023-PPCC.calendari -E 1 2023 12 > any-2023-PPCC.pdf

On els arguments tenen els següents objectius:

• -r Latin1: indica que la codificació del fitxer és Latin1 o ISO-8859-15;
• -a ca : idioma català (per als noms dels mesos i dels dies);
• -P a4 : mida de les pàgines (l’orientació per omissió és horitzontal);
• -F1 : primer dia de la setmana, dilluns;
• -B : deixar en blanc (i no en gris) els requadres que no mostren cap dia);
• -f any-2023-PPCC.calendari : fitxer amb els festius i altres indicacions.
• -E : format europeu de dates (dia/mes o dia/mes/any);
• 1 2023 12 : el calendari inicia al gener (1) de 2023 i conté 12 mesos;
• > any-2023-PPCC.pdf : nom del fitxer de sortida.

L’ordre per a crear el calendari es pot simplificar molt si introduïm la major part dels arguments a l’inici del fitxer de text que el defineix. Per exemple, podem substituir la primera línia del nostre exemple per les següents:

### OPCIONS

opt -a ca	  # Mesos i dies en català
opt -P a4	  # Mida dels fulls
opt -F 1	  # Primer dia de la setmana: dilluns (1); pot anar de 0 a 6.
opt -B		  # Evita que els requadres sense dia queden en gris.
opt -E 		  # Indica que les dates van en format europeu (d/m/y o d/m)
opt -r Latin1     # ISO-8859-15 (cal desar el fitxer en aquesta codificació)
opt -C "Calendari dels Països Catalans" 

opt -o any-2023-PPCC-NOVISSIM.pdf ##### FITXER DE SORTIDA

Un cop fet això, l’ordre per generar el calendari es reduirà a:

pcal -f any-2023-PPCC.calendari 1 2023 12

És a dir, que només ens caldrà indicar el fitxer a utilitzar (-f any-2023-PPCC.calendari), el mes d’inici del calendari (1), l’any que desitgem imprimir (2023) i el total de mesos que volem (12).

En canvi, si el que volem obtenir és un calendari escolar del setembre al juny, caldria escriure l’ordre:

pcal -f any-2023-PPCC.calendari 9 2023 10

És a dir, caldria indicar que el calendari ha de començar el novè mes i durar deu mesos.

Pcal pot fer moltes coses més. Per exemple, pot incloure informació sobre les fases lunars (amb els arguments -m o -M, «moon»), pot mostrar els mesos en vertical (amb -p, «portrait»), pot crear un calendari anual en forma de graella (amb -w). Fins i tot, pot incloure imatges en format EPS (això no ho he provat encara).

Pcal és una eina antiga, però d’una gran potència (com ho solen ser totes les eines basades en text i en el terminal, d’altra banda). Ben flexible, ens permet crear ràpidament calendaris complexos sense perdre’n la claredat. El major inconvenient que li trobe és aquell detall de la codificació (que se supera desant el fitxer com a Latin1 o ISO-8859-1 i aplicant l’argument «-r Latin1», bé en la línia d’ordres, bé en el propi fitxer font).