Doc: Add GPL logo and minor change.

This commit is contained in:
Pierre-Antoine Rouby committed 2023-09-18 09:55:53 +02:00
1 parent 9f9dd508b1
commit 436f4adaf6
5 files changed
+58 -48

No files matched your search

+18 -11
View File
@@ -28,6 +28,9 @@
#+OPTIONS: toc:t
#+LANGUAGE: UKenglish
#+BEGIN_ABSTRACT
#+END_ABSTRACT
* Introduction
Pamhyr2 is free and open source software (FOSS) graphical user
@@ -126,6 +129,7 @@ print(f"Document build on system: {os.name}")
If you use GNUEmacs, it is also possible to run the code inside a
block and export (or not) the reuslts in the document.
#+OPTIONS: float:nil
#+CAPTION: Get os type name in Python code
#+begin_src python :python python3 :results output :exports both :noweb yes
import os
@@ -138,15 +142,15 @@ print(f"Document build on system: {os.name}")
*** Latex
If we export the file to PDF, org-mode use \LaTeX. So we can add some
piece of \LaTeX into the document[fn:: See \LaTeX part in
documentation: https://orgmode.org/org.html#Embedded-LaTeX (last
If we export the file to PDF, org-mode use {{{latex}}}. So we can add
some piece of {{{latex}}} into the document[fn:: See {{{latex}}} part
in documentation: https://orgmode.org/org.html#Embedded-LaTeX (last
access 2023-09-15)]. For exemple, we can add math formula like
=$E=mc^2$= ($E=mc^2$) or =\[E=mc^2\]=:
\[E=mc^2\]
But we can also add every type of \LaTeX:
But we can also add every type of {{{latex}}}:
#+BEGIN_EXAMPLE
# Add latex in line
@@ -158,9 +162,9 @@ But we can also add every type of \LaTeX:
#+END_EXPORT
#+END_EXAMPLE
It is also possible to add specific \LaTeX file header with
It is also possible to add specific {{{latex}}} file header with
=#+LATEX_HEADER=. In this document we use the file
{{{file(doc/tools/latex.org)}}} for all \LaTeX headers.
{{{file(doc/tools/latex.org)}}} for all {{{latex}}} headers.
*** Macro
@@ -211,7 +215,7 @@ a lot better than it used to.
*** References
The references use the \LaTeX bibtex tools. The bib file is in
The references use the {{{latex}}} bibtex tools. The bib file is in
{{{file(/doc/tools/ref.bib)}}} and use for developers and user
documentation. In document, use ={{{cite(<name>)}}}= to cite a paper.
@@ -221,18 +225,21 @@ To export the files, a {{{build.sh}}} script is available in the org
files directories. On GNU/Linux system you can build the documentation
PDF file with the command =./build.sh=. Texlive package must be
installed, you can install only needed packages or all texlive
packages, for example on Debian (and some derived system):
packages, for example on Debian (and some derived system) use command
Listing [[texlive-install]].
#+NAME: texlive-install
#+CAPTION: Installation command for texlive full on Debian system
#+begin_src shell
sudo apt install texlive-full
sudo apt install texlive-full
#+end_src
Some org-mode configuration used in documentations files are define
in =/doc/tools/=:
- {{{file(PamhyrDoc.cls)}}}: The \LaTeX theme
- {{{file(PamhyrDoc.cls)}}}: The {{{latex}}} document class
- {{{file(macro.org)}}}: Available macro
- {{{file(latex.org)}}}: \LaTeX configutation for documentations files
- {{{file(latex.org)}}}: {{{latex}}} configutation for documentations
files
- {{{file(setup.el)}}}: GNUEmacs configuration to build documentations
- {{{file(ref.bib)}}}: Bibtex files for documentations files