summaryrefslogtreecommitdiff
path: root/info/visualfaq-fr/source/README
blob: 5ee8f435d4e5f1675779fd05e2e64e67ebdc45b2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
                         ___ _____ ___  ___ _
                        / __|_   _/ _ \| _ \ |
                        \__ \ | || (_) |  _/_|
                        |___/ |_| \___/|_| (_)


(English summary below)

Le fichier le plus important de ce package est le PDF `visualFAQ-fr.pdf`.
Voici quelques pistes pour aller plus loin:

    Si vous voulez associer      ---\  téléchargez l'extension
    des notes contextuelles et   ---/  "cooltooltips" du CTAN.
    des infobulles
    à des hyperliens


    Si vous voulez voir un       ---\  lisez la documentation
    exemple de code pour une     ---/  de l'extension recommandée
    réponse particulière               dans la réponse de la FAQ.
    de la FAQ.


    Si vous voulez recompiler    ---\  Ne vous embêtez pas ;
    la FAQ pour une raison       ---/  son contenu a été mis en page
    quelconque.                        manuellement et le fichier PDF
                                       a été post-traité.


Le code-source de la FAQ LaTeX Visuelle doit nécessairement utiliser
un certain nombre d'astuces grossières et constitue le plus souvent
une illustration de la mauvaise façon de faire les choses. Par exemple,
l'insertion d'hyperliens autour d'exemples de mise en page demande pas
mal d'astuces: si vous ne pouvez pas mettre quelque chose dans une
`\fbox` et obtenir un résultat correct, vous ne pourrez pas non plus
mettre facilement un lien hypertexte autour. Ensuite, certaines
extensions ont des fonctionnalités contradictoires. Un exemple:
`parskip.sty` fixe l'indentation de tous les paragraphe à zéro alors
que `indentfirst.sty` fixe l'indentation de tous les paragraphes
à une valeur non nulle. Il est clair qu'un fichier LaTeX n'a aucun
intérêt à charger les deux extensions en même temps.

Le fichier `visualFAQ-fr.pdf` sur le CTAN a été post-traité pour inclure
des vignettes des pages et pour supporter le mode "Fast Web View"
(aussi appelé "PDF linéarisé"). La recompilation du PDF entraînera
la perte de ces métadonnées.  Il est également déconseillé de modifier
le document, y compris sa mise en forme.  En raison de l'utilisation
intensive de boîtes TeX insécables, le document est très sensible
à la mise en page.  Toute modification risque d'entraîner l'apparition
de vilains espaces blancs inter et intra-paragraphes dans tout
le document.

En bref, la meilleure façon d'utiliser la FAQ LaTeX Visuelle est de
la prendre comme elle est, de parcourir le fichier `visualFAQ-fr.pdf`,
de cliquer sur les hyperliens qui vous intéressent et d'apprendre
ce que la FAQ LaTeX francophone a à vous dire.

               https://faq.gutenberg.eu.org/


# English summary

The source to the Visual LaTeX FAQ necessarily has to utilize a number
of crude hacks and is more often than not a demonstration of how *not*
to achieve a particular effect. You're best off using the Visual LaTeX
FAQ as it was intended: browse through the prebuilt `visualFAQ-fr.pdf`
file, click on hyperlinks of interest, and learn from what the
French-speaking LaTeX FAQ has to say.

                https://faq.gutenberg.eu.org/


If you want more information in English, please have a look at the
original package:
                https://ctan.org/pkg/visualFAQ
                https://github.com/spakin/visualFAQ