Caràcters accentuats a les propietats PDF del document

Els documents PDF tenen una característica força interessant que permet conèixer-ne el contingut sense necessitat d’obrir-los. Ens referim a les Propietats del document. Per accedir-hi només cal fer clic sobre Propietats del fitxer (que apareixen al clicar el botó dret del ratolí sobre el nom del fitxer quan el tenim en el navegador de fitxers):

També podem accedir-hi amb el document PDF obert en qualsevol lector (com ara Okular, Evince o Adobe Reader) des del menú Fitxer -> Propietats:

Ara bé, quan es generen PDFs des de LaTeX moltes vegades ens trobem amb problemes perquè el format no accepta segons quins caràcters en aquests camps. En concret no admet paraules accentuades provinents del comandament:

\hypersetup{
 pdfauthor=NomAutor,
 pdftitle=Títol,
 pdfsubject=TemaDelDocument,
 pdfkeywords=ParaulesClau,}

En aquest article, però, veurem un truc que podem usar per fer-les aparèixer. Es tracta d’aprofitar una de les eines del paquet hyperrref: el comandament

\pdfstringdef{variable}{CadenaDeText} 

Aquest comandament permet introduir una CadenaDeText amb els caràcters accentuats i passar-la a una variable que, en acabat podem traslladar a les propietats del document a través de hypersetup.
Vegem-ne un exemple usat per fer el document PDF adjunt a aquest article el codi del qual es pot trobar també el el fitxer tex font adjunt. Primer definim la variable Titol:

\pdfstringdef{\Titol}{Caràcters accentuats a les propietats PDF del document}

Ara podem escriure:

\hypersetup{pdftitle=\Titol}

i quan processem el document, a la propietat del PDF "Títol" apareixerà el text amb les vocals accentuades.

Aprofitem l’avinentesa per tractar d’un altre comandament del paquet hyperrref que permet fer aparèixer textos alternatius als marcadors del PDF. Als marcadors dels PDF (bookmarks) no hi podem aparèixer fórmules matemàtiques, per exemple, però sí al títol de la secció que obren aquests marcadors.

Per solucionar el problema i tenir un text alternatiu per al marcador podem usar el comandament:

\texorpdfstring{TextLaTeX}{TexAlternatiuSenseLaTeX}

Per exemple, si obriu els marcadors del PDF adjunt veureu que la primera secció titulada al document La fórmula de l’àcid sulfúric H₂SO₄ en el marcador apareix simplement com a: La fórmula de l’àcid sulfúric per evitar que la fórmula no surti mal escrita. Això s’ha aconseguit escrivint:

\section{\texorpdfstring {La fórmula de l'àcid sulfúric $H_{2}SO_{4}$}{La fórmula de l'àcid sulfúric}}

• Document tex font per estudiar-ne el codi o usar-lo de plantilla.
• Resultat en format PDF.
• bibliografia

Publicat per primera vegada el dissabte 13 de febrer de 2010.

Trencar URLs amb seny

Quan en un document volem donar una URL, com que solen ser molt llargues, o bé surten dels marges de l’escrit, o bé queden trencades per on menys esperem.

El paquet breakurl permet trencar les URL de manera que quedin dins dels marges del text i el resultat visual sigui mínimament lògic. A més, com que treballa conjuntament amb el paquet hyperref, segueix creant els hiperenllaços dins el document PDF.

El seu ús és molt senzill, només cal cridar al paquet després de l’hyperref al preàmbul del document:

\usepackage{hyperref}

\usepackage{breakurl} 

Després, al cos del document, quan haguem d’escriure la URL, en lloc del clàssic \href{url}{text} o bé \url{url}, escriurem

\burl{url}

Aquest comandament crea l’enllaç a la url en el document PDF alhora que la talla pel lloc més adient, que pot ser:

• els dos punts :
• la barra /
• el punt .
• l’interrogant ? (usat a les urls de php)
• el coixinet #
• el símbol &
• altres.

Un altre comandament força útil que proporciona el paquet és

\burlalt{url real}{url mostrada}

equivalent a \href{url real}{url mostrada}, que crea l’enllaç al lloc adient, però mostra una url més abreujada o fàcil de recordar, per exemple:

\burlalt{http://www.xtec.cat/~jqueralt/index.htm}{www.xtec.cat/~jqueralt}

• Document tex font per estudiar-ne el codi
• Resultat en format PDF 

+info: documentació del paquet breakurl

Publicat per primera vegada el diumenge 30 de desembre de 2007.

Propietats del document PDF

Com saber què hi ha en un document PDF sense necessitat d’obrir-lo

Amb un clic de botó dret del ratolí podem saber les propietats d’un document PDF. Si teniu un ordinador no massa nou (com és el meu) haureu vist que costa una mica d’arrencar el lector de PDFs, normalment l’Adobe Acrobat. Per això a vegades fa mandra, o costa molt de temps obrir un darrere l’altre una sèrie de fitxers PDF per saber què hi ha.

Tanmateix el format PDF és tan potent que suporta una sèrie de camps que poden contenir informació molt útil. Com omplir aquests camps? És molt senzill si creem els PDF des de fitxers tex amb el paquet hyperref. Només cal omplir la següent informació al preàmbul:

\usepackage[pdfauthor={Joan Queralt Gil},%%
pdfsubject={tema del document},%
pdfkeywords={paraules clau},%%
pdftitle={titol del doc sense accents},%%
pdftex]{hyperref}

Ara només fent un clic amb el botó dret del ratolí sobre la icona del fitxer PDF triem Propietats del menú emergent i cliquem la solapa Propietats de PDF. Veurem tot allò que hi hem inclòs sense haver d’engegar el lector de PDFs.

Article publicat per primera vegada el 27/1/2005

Enllaços actius i acolorits en PDF

El paquet hyperref permet que els enllaços d’un document PDF siguin funcionals i de diferents colors.

Quan estem llegint un document PDF ens és molt útil que els hiperenllaços siguin actius. És a dir, que quan veiem una adreça web puguem clicar-hi i que s'obri una finestra del navegador amb aquesta pàgina. O que quan estiguem veient l'índex del document puguem fer clic sobre una determinada subsecció i anar-hi. O que quan estem llegint el text i hi hagi una pàgina referenciada puguem fer clic a sobre i anar-hi directament. A més, pot ser interessant que hi hagi enllaços que governin
accions del programa lector del PDF, per exemple, que tanquin el document o que passin pàgina.

El paquet hyperref crea aquests documents PDF tan potents. També permet acolorir els enllaços de diferents colors segons el tipus del que es tracti:

linkcolor: color dels enllaços interns de document. P.ex: a una pàgina, secció, subsecció, etc

urlcolor: color dels enllaços externs, siguin a Internet (una adreça web), siguin a un altre document

menucolor: color dels enllaços a menús del lector de PDF (Okular, Acrobat, etc)

També permet decidir com s'obrirà el document:

• pdfpagemode=FullScreen  l'obre en pantalla completa, sense barres de menus ni icones, none a la finestra del lector
• pdfstartview=FitH  el document s'ajusta a l'amplada de la finestra o si s'han de veure, i com, el marcadors:
• bookmarksopen  quan s'obre el document mostra els marcadors de les seccions, subseccions, etc a l'esquerra.
• bookmarksnumbered  mostra els marcadors numerats: 3, 2.1, 4.1.5, etc

Per obtenir la potencialitat d'aquest paquet només cal cridar-lo, amb les opcions desitjades, al preàmbul del document:

\usepackage[colorlinks,         % activa els colors als enllaços
        linkcolor=blue,         % color de l'enllaç intern
        anchorcolor=red,        % color del text d'ancoratge
        menucolor=OliveGreen,   % color dels enllaços a menús d'Acrobat(p.ex: pàgina següent)
        urlcolor=Brown,         %color dels enllaços d'internet
        pdfpagemode=none,       % obre només la pàgina en vista 162%; FullScreen en pantalla completa
        pdfstartview=FitH,      % la vista inicial és de pàgina ajustada a l'ample de la finestra
        hyperindex,             % fa que l'índex sigui hipertextual
        bookmarksopen,          % quan s'obre el document mostra els marcadors de seccions a l'esquerra
        bookmarksnumbered       % fa que el marcadors quedin numerats per capítols, seccions, subseccions, etc
        ]{hyperref}

Als documents adjunts trobareu un exemple en PDF de com pot quedar un document que utilitza el paquet hyperref i el fitxer tex font del que s'ha obtingut.

Document tex font: hyperref.tex
Resultat: hyperref.pdf

Publicat originalment el dimecres 22 de juny de 2005.