Commit 6addcae7 authored by arpinux's avatar arpinux

update sync version fr

parent 5238a433
Pipeline #17892 passed with stages
in 45 seconds
......@@ -11,6 +11,8 @@ You will be able to **go further** and obtain information concerning the privacy
Usually, the manuals begin by teaching you the theoretical basis and the usage of the terminal. This manual takes the very side of the "graphical environment": it is designed to let you start quickly with Debian, screen powered on, fingers on the keyboard and the mouse nearby.
---
**-- The mission of this manual is not to be comprehensive. --**
A lot of external links are available in this manual. Don't hesitate to click on them in order to read more detailed information.
......@@ -19,9 +21,12 @@ For a more detailed documentation, please visit the official Debian Wiki: [https
If you need a complete Debian manual, please read the **Debian Administrator Handbook** from Raphaël Hertzog and Roland Mas [https://debian-handbook.info/browse/stable/](https://debian-handbook.info/browse/stable/).
---
**-- How to use this manual?--**
This PDF version includes a more detailed summary at the end of the guide.
This PDF version includes a detailed summary and a table of figures at the end of the guide.
Note: This manual includes some commands or code blocks that are sometimes longer than the width of the page. In this case, a backslash `\` is added and the rest of the command or code is carried over to the next line.
---
......
......@@ -21,7 +21,7 @@ If you need a complete Debian manual, please read the **Debian Administrator Han
**-- How to use this manual?--**
This ePUB version includes a detailed summary and search function of your eBook reader;)
This ePUB version includes a detailed summary and search function of your eBook reader.
---
......
......@@ -143,7 +143,8 @@ Debian is an operating system (the big piece of software making your computer f
Imagine your computer is like your house. If your favorite book is located in a certain place, this "place" is like an address relative to the "house". For example, if the book stands in the second drawer of your nightstand, one can define its address (the path to follow in order to reach it) like this: Home,bedroom,nightstand,2nd drawer,favorite book.
To separate the various "items" we use the "/" symbol, which gives the following address in computer language: /home/bedroom/nightstand/2nd drawer/favorite book.
The "root of the system is symbolized by a simple "/". The main folder containing all the users data is symbolized by "/home/, and your personal folder is named "/home/Alice/".
If we come back to the favorite book example, its address could be: "/home/Alice/Documents/books/my_favorite_book.pdf"
If we come back to the favorite book example, its address could be:
"/home/Alice/Documents/books/my_favorite_book.pdf"
### Your personal data
......@@ -219,7 +220,11 @@ Once selected, you can apply the modifications to these items as detailed in the
#### Classifying the data
You are going to say: "*I can do whatever I want with my own data*" ... and **you are damn right** !
You are going to say:
> *I can do whatever I want with my own data*
... and **you are damn right** !
However some applications will access your data more easily if they are stored in their specific folders. Thus, the screen capture program will record its shots in the "Pictures" folder, the Internet navigator will record your downloaded files in the "Downloads" folder, the music player will look into the "Music" folder ... And so on.
**Thunar** allows you to create shortcuts to ease the access, the classification and thus the retrieving of your data.
......
......@@ -193,9 +193,7 @@ More information at: http://www.boot-disk.com/boot_priority.htm
As mentioned above, the key to access the Boot Menu at start-up may vary from one computer to another. This specific key as well as the key to access the BIOS configuration is usually indicated during the boot sequence for one or two second:
![](img/bootmenu1.png)\
![](img/bootmenu2.png)\
![open the boot menu](img/bootmenu1.png)
The boot menu let you select the boot peripheral without going into the BIOS configuration
......
......@@ -359,11 +359,12 @@ Debian uses three different default connection managers: **GDM** (on Gnome & Cin
You can setup **LightDM** ([https://wiki.debian.org/LightDM](https://wiki.debian.org/LightDM)) by editing its main configuration file. To enable autologin, you'll have to edit it with a root terminal (chap.3.8.3).
Open a terminal and become root with the "**su**" command. The administrator password will be asked. Once connected in root terminal, copy (to backup) and edit the dedicated file with:
Open a terminal and become root with the "**su**" command. The administrator password will be asked. Once connected in root terminal, copy (to backup) and edit the dedicated file with in 2 commands:
cp /etc/lightdm/lightdm.conf /etc/lightdm/lightdm.conf.bak && nano /etc/lightdm/lightdm.conf
cp /etc/lightdm/lightdm.conf /etc/lightdm/lightdm.conf.bak
nano /etc/lightdm/lightdm.conf
This command opens the configuration file in the CLI **Nano** editor. Use arrows to scroll and locate those lines:
The second command opens the configuration file in the CLI **Nano** editor. Use arrows to scroll and locate those lines:
#autologin-user=
#autologin-user-timeout=0
......
......@@ -121,7 +121,7 @@ To configure the widgets, left-click on the relevant component to bring up the c
The Activity manager let you organize your tasks and keep an eye on them. To access it, left-click on the top-left corner menu or right-click on the desktop:
![](img/deb9-kde-activities1.png)
![access to activities](img/deb9-kde-activities1.png)
The activity banner will then appear at the left of the screen and display the current and pending activities. Each activity can be configured to separate your tasks and associate certain settings (for example, deleting the browsing history).
......@@ -266,11 +266,11 @@ Open a terminal in administrative mode (voir chap.3.8.3) with the "**su**" comma
Modify the sources.list file by adding the contrib and non-free section, like this:
###### Debian Main Repos
deb http://ftp.debian.org/debian/ stretch main contrib non-free
deb http://deb.debian.org/debian/ stretch main contrib non-free
###### Debian Update Repos
deb http://security.debian.org/ stretch/updates main contrib non-free
deb http://ftp.debian.org/debian/ stretch-updates main contrib non-free
deb http://deb.debian.org/debian/ stretch-updates main contrib non-free
Save your modifications with [Ctrl]+x in the Nano text editor, then "Y" for "Yes".
Reload the repository informatin, and install the non-free firmware:
......
......@@ -9,7 +9,7 @@ Debian GNU/Linux uses the repository methodology to distribute applications. Thi
The Internet addresses of the Debian repositories are stored in the **/etc/apt/sources.list** and the files of the type **/etc/apt/sources.list.d/xxx.list**.
![The default 'sources.list' file on Debian 9](img/deb9-sourceslist.png)
![An example of 'sources.list' file on Debian 9](img/deb9-sourceslist.png)
Details concerning the various information found in the 'sources.list' file (the lines beginning with a "#" are just comments):
......@@ -67,11 +67,11 @@ This command opens the appropriated file with the default text editor (nano or v
**Example of line entry for the free packages:**
deb http://ftp.debian.org/debian/ stable main
deb http://deb.debian.org/debian/ stable main
**Example of line entry for the free packages and the proprietary packages:**
deb http://ftp.debian.org/debian/ stable main contrib non-free
deb http://deb.debian.org/debian/ stable main contrib non-free
Now you can help yourself in the 3 package sections and install the non-free codecs and drivers.
......@@ -204,7 +204,7 @@ You only have to click on the "Apply" button, and accept the requested confirmat
![](img/synaptic-upgrade-apply.png)
![confirm changer](img/synaptic-upgrade-confirm.png)
![confirm changes](img/synaptic-upgrade-confirm.png)
The system updating process begins with the package downloading, and continues with their installation. A message informs you that all the changes were applied.
......@@ -383,9 +383,10 @@ In our example, an update series that includes the "operating system update" req
You then have to restart by clicking on the dedicated button.
![](img/deb9-gnome-update-btn.png)
![](img/deb9-gnome-update-btn.png)\
![](img/deb9-gnome-update-3.png)
![reboot to apply updates](img/deb9-gnome-update-3.png)
Note that for smaller updates, restart is not necessary.
......
......@@ -199,7 +199,7 @@ Please note that using Tor might slow down your Internet navigation.
On the main site, you can read ...
![tails banner](img/tails_banner.png)
![tails banner](img/tails_banner.png)\
Tails is a live (autonomous) operating system that you can start on almost any computer from a DVD, USB stick, or SD card. It aims at preserving your privacy and anonymity, and helps you to:
......@@ -213,4 +213,5 @@ For more information, you can visit the Tails download page [https://tails.boum.
Note that the TOR navigation is often slowed down, and that some site or functionalities will not be reachable, due to their embedded scripts or their "privacy" policies ...
Is it the right time to sort out through all your bookmarks ?
!["Plant onion!" by Péhä (CC-BY)](img/plantonion-by_peha.png)
!["Plant onions!" by Péhä (CC-BY)](img/plantonion-by_peha.png)
This diff is collapsed.
......@@ -6,8 +6,11 @@ Sources of this manual are freely available in its GIT repository: [https://git.
- Sources edition: Geany [https://www.geany.org/](https://www.geany.org/) & VIM [http://www.vim.org/](http://www.vim.org/)
- Screenshots: scrot [https://en.wikipedia.org/wiki/Scrot](https://en.wikipedia.org/wiki/Scrot)
- Pictures edition: Gthumb [https://wikipedia.org/wiki/GThumb](https://wikipedia.org/wiki/GThumb), the Gimp [https://www.gimp.org](https://www.gimp.org) & Imamagick [https://www.imagemagick.org](https://www.imagemagick.org)
- Logos edition: Inkscape [https://inkscape.org](https://inkscape.org) & the Gimp
- Pictures edition: Gthumb
[https://wikipedia.org/wiki/GThumb](https://wikipedia.org/wiki/GThumb),
the Gimp [https://www.gimp.org](https://www.gimp.org),
Inkscape [https://inkscape.org](https://inkscape.org) & Phatch
[http://photobatch.wikidot.com](http://photobatch.wikidot.com)
- HTML public export: MkDocs [http://www.mkdocs.org/](http://www.mkdocs.org/)
- External exports in PDF, HTML, ODT & EPUB : Pandoc [http://pandoc.org/](http://pandoc.org/)
- PDF optimization: ps2pdf [https://www.ps2pdf.com/](https://www.ps2pdf.com/) & Exiftool [https://en.wikipedia.org/wiki/ExifTool](https://en.wikipedia.org/wiki/ExifTool)
......@@ -42,5 +45,5 @@ For this Stretch release, thanks to BibiSky51 for its rereading and advices, to
**Special thx 2 Péhä for his drawings (under CC-BY-SA) and his free spirit** [https://lesptitsdessinsdepeha.wordpress.com](https://lesptitsdessinsdepeha.wordpress.com).
![by Péhä](img/handylinux2.4released-mod.jpg)
![by Péhä CC-BY-SA](img/walltlpd-bypeha-ccbysa.png)
......@@ -6,18 +6,20 @@
LOG="pandoc.log"
MANHD="lcdd-hd.pdf"
MANUEL="the_beginners_handbook.pdf"
MANPRINT="the_beginners_handbook_print.pdf"
# place nette
if test -f $LOG; then rm $LOG; fi
if test -f $MANHD; then rm $MANHD; fi
if test -f $MANUEL; then rm $MANUEL; fi
if test -f $MANPRINT; then rm $MANPRINT; fi
# make pdf
echo "export en PDF depuis les sources MD"
pandoc \
--verbose \
-s -S --normalize \
-f markdown_strict+pipe_tables+yaml_metadata_block \
-f markdown \
--listings \
--latex-engine=xelatex \
--template=pandoc-tpl.tex \
......@@ -44,17 +46,23 @@ if test -f $MANHD; then
# optimisation du pdf
echo "\noptimisation du PDF\n"
ps2pdf -dPDFSETTINGS=/ebook $MANHD $MANUEL
echo "\noptimisation de \"$MANUEL\" terminée.\n"
echo "\noptimisation de la version imprimable\n"
ps2pdf -dPDFSETTINGS=/default \
-sColorConversionStrategy=Gray \
-dProcessColorModel=/DeviceGray \
$MANUEL $MANPRINT
echo "\noptimisation de \"$MANPRINT\" terminée.\n"
# données EXIF
echo "\nfix exif datas\n"
exiftool -Title="The beginner's handbook" -Author="3hg team © WTFPL" \
-Subject="Debian manual for very beginners" -overwrite_original $MANUEL
echo "\noptimisation de \"$MANUEL\" terminée.\n"
# clean
echo "nettoyage"
rm $MANHD $LOG
exit 0
else
echo "ERROR: \"$MANUEL\" non généré > vérifiez le $LOG"
echo "ERROR: \"$MANUEL\" & \"$MANPRINT\" non générés > vérifiez le $LOG"
exit 1
fi
......@@ -3,30 +3,39 @@
%----------------------------------------------------------------------
% document class : article/proc/book/minimal/report/memoir/letter...
\documentclass[a4paper,12pt]{book}
% mise en page et taille
\usepackage{geometry}
\geometry{top=65pt,bottom=70pt,right=50pt,left=50pt}
% GNU FreeFont Sans
\usepackage{fontspec}
\setmainfont{FreeSans}
% monofont
\setmonofont{Hack}
% captions
\usepackage[font={small,it},labelsep=space]{caption}
% captions sans label ni numéro.
\usepackage[font={small,it},labelformat=empty]{caption}
% hauteur de ligne
\usepackage{setspace}
\setstretch{1.25}
% français par défaut
\usepackage[english]{babel}
\usepackage[shorthands=off,english]{babel}
% pas de page vide
\let\cleardoublepage\clearpage
% ?? FIXME
\usepackage{amssymb,amsmath}
\usepackage{ifxetex,ifluatex}
% mise en page et taille
\usepackage{geometry}
\geometry{top=65pt,bottom=70pt,right=50pt,left=50pt}
% prise en charge des images
\usepackage{graphicx}
\usepackage{grffile}
\usepackage{floatrow}
%\usepackage{floatrow}
% forcer le positionnement des images dans le texte
\usepackage{float}
\let\origfigure\figure
\let\endorigfigure\endfigure
\renewenvironment{figure}[1][2] {
\expandafter\origfigure\expandafter[H]
} {
\endorigfigure
}
\usepackage[export]{adjustbox}
% plus de couleurs
\usepackage[dvipsnames]{xcolor}
......@@ -56,17 +65,23 @@
\renewcommand{\footrulewidth}{0pt} % pas de ligne en footer
\lhead{\itshape{\nouppercase{\rightmark}}}
\chead{}
\rhead{\hyperref[toc]{Contents}}
\lfoot{\href{https://lescahiersdudebutant.fr}{the beginner's handbook}}
\rhead{}
\lfoot{\href{https://lescahiersdudebutant.fr}{lescahiersdudebutant.fr}}
\cfoot{\thepage}
\rfoot{\href{https://git.framasoft.org/dflinux/thebeginnershandbook}{\textit{git'sources}}}
\rfoot{\hyperref[toc]{Sommaire}}
% liste à puces rondes pas fr
%\frenchbsetup{StandardLists=true}
% profondeur de la numérotation
\setcounter{secnumdepth}{4}
% titres #1 custom : seul sur une page colorée
\usepackage{titlesec}
\titleformat{\chapter}[hang]{\vspace{20ex}\thispagestyle{empty}\pagecolor{Chaptercolor}\color{white}\vbox{\rule{\textwidth}{20pt}}\vspace{2ex}\bfseries\LARGE}%
{\thechapter}{.5ex}{\centering}[\vspace{1.2ex}\rule{\textwidth}{20pt}\clearpage\pagecolor{white}]%
{\bfseries\LARGE}
%\titleformat{\chapter}[hang]{\vspace{20ex}\thispagestyle{empty}\pagecolor{Chaptercolor}\color{white}\vbox{\rule{\textwidth}{20pt}}\vspace{2ex}\bfseries\LARGE}%
% {\thechapter}{.5ex}{\centering}[\vspace{1.2ex}\rule{\textwidth}{20pt}\clearpage\pagecolor{white}]%
% {\bfseries\LARGE}
% titres #1 custom
\titleformat{\chapter}[hang]{\vspace{10ex}\color{Covercolor}\bfseries\Huge}%
{\thechapter}{.5ex}{\centering}[\vspace{1.2ex}]%
{\bfseries\Huge}
% titre #2 custom : bandeau de couleur
\titleformat{\section}[block]{\color{white}\bfseries\Large}{}{0pt}{\colorsection}
\titlespacing*{\section}{0pt}{\baselineskip}{\baselineskip}
......@@ -80,10 +95,12 @@
\titleformat{\subsubsection}[hang]{\color{Covercolor}\bfseries\large}%
{\thesubsubsection}{.5ex}{}%
{\bfseries\large}
% codes avec cadre 3D et couleur
% nouvelle page pour chaque section si class=article
%\newcommand{\sectionbreak}{\clearpage}
% codes sans cadre
\usepackage{listings}
\lstset{backgroundcolor=\color{blue!10},xleftmargin=1ex,xrightmargin=1ex,
frame=tlBR,language=sh,basicstyle=\ttfamily\small,breaklines=true,
\lstset{backgroundcolor=\color{gray!10},xleftmargin=1ex,xrightmargin=1ex,
frame=leftline,language=sh,basicstyle=\ttfamily\small,breaklines=true,
prebreak={\textbackslash}}
% images ne pas dépasser la zone de texte
\raggedbottom
......@@ -91,7 +108,6 @@
\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
\def\maxheight{\ifdim\Gin@nat@height>\textheight\textheight\else\Gin@nat@height\fi}
\setlength\@fptop{0\p@}% float at the top
\renewcommand{\fnum@figure}{fig. \thefigure}% label pour les illustrations
\makeatother
\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
% tables
......@@ -125,7 +141,7 @@ $endfor$
{\Large Debian 9 Stretch}
\vfill
{\normalsize $author$\vskip5pt}
Updated : \today\vskip5pt
Updated: \today\vskip5pt
\rule{\textwidth}{.75pt}
\end{titlepage}
$for(include-before)$
......@@ -142,6 +158,9 @@ $endfor$
\setcounter{tocdepth}{4}
\tableofcontents\label{toc}
\clearpage
% lof
\listoffigures\label{pics}
\clearpage
% fin
\begin{centering}
\thispagestyle{empty}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment