Browse Source

Séparation de la forme et du fond

Modification du Makefile
Création d'un fichier de style pour les commandes et environnements utilisés
master
bendia 8 years ago
parent
commit
f98949fce7
7 changed files with 641 additions and 47 deletions
  1. +3
    -1
      APropos
  2. +17
    -7
      src/Makefile
  3. +43
    -31
      src/deb5min.tex
  4. +25
    -0
      src/ebook-facile.sty
  5. +5
    -8
      src/ebook-facile.tex
  6. +548
    -0
      src/framed.sty
  7. BIN
      src/images/ampoule.png

+ 3
- 1
APropos View File

@@ -6,7 +6,9 @@ La discussion sur le projet peut se dérouler [sur ce fil](http://debian-facile.
L'outils utilisé pour réaliser cet ebook est Latex
Afin d'obtenir un peu d'aide sur latex :
- [Site du Zero](http://www.siteduzero.com/informatique/tutoriels/redigez-des-documents-de-qualite-avec-latex)
- [Vincent Lozano }(http://lozzone.free.fr/index.php?vlunch=latex)

# Procédure :
- Les sources servant à construire l'ebook en pdf se trouveront dans src. Le fichier principal se nomme ebook-facile.tex. Les différentes parties peuvent être compilé dans le fichier principale avec un \include. Les images se trouvent dans le dossier images.
- Pour lancer la création d'une image, se place dans le dossier src, puis lancer make
- Les différentes commandes et environnements de mise en page sont dans le fichier ebook-facile.sty. Il semble préférable de créer une commande ou un environnement et de l'appliquer ensuite dans le document plutôt que de faire la mise en forme directement dans le document.
- Pour lancer la création du document, se place dans le dossier src, puis lancer make. Cela compilera le fichier en PDF. Il peut être généré en DVI avec make dvi. Imagemagick doit alors être installé pour convertir les images png et jpeg en ps.

+ 17
- 7
src/Makefile View File

@@ -1,22 +1,32 @@
.PHONY: clean help mrproper
SHELL := /bin/bash
EXT=aux out toc
OUT=pdf epub dvi log

all:
$(MAKE) ebook
$(MAKE) pdf

ebook:
pdf:
@echo "Compilation de l'ebook..."
@pdflatex ebook-facile.tex && pdflatex ebook-facile.tex

dvi:
@if [ ! -d "images/ps" ];then mkdir images/ps;fi; mogrify -format ps images/*.png images/*.jpeg; mv images/*.ps images/ps;
@latex ebook-facile.tex && latex ebook-facile.tex
clean:
@echo "Nettoyage..."
@rm *.aux *.out *.toc
@for ext in $(EXT);do rm -f *.$$ext;done
mrproper:
@$(MAKE) clean
@echo "Grand nettoyage"
$(MAKE) clean
@rm *.pdf *.log
@for ext in $(OUT);do rm -f *.$$ext;done

help:
@echo "make pdf : compile le fichier .tex en pdf"
@echo "make dvi : compile le fichier .tex en dvi"
@echo "make clean : Nettoyage"
@echo "make build : compile le fichier .tex"
@echo "make mrproper : Nettoyage des fichiers intérmédiaire et du fichier pdf généré"
@echo "make mrproper : Nettoyage des fichiers intérmédiaire et des fichiers de sorties (pdf dvi ...) générés"

+ 43
- 31
src/deb5min.tex View File

@@ -7,19 +7,20 @@

Debian, permet le fonctionnement d'un ordinateur, et propose un ensemble complet de logiciels libres avec leurs mises à jour, pour tous les usages habituels, et plus encore…

Ces logiciels libres proviennent en grande partie du projet GNU\footnote{\url{http://www.gnu.org/home.fr.html}}, lancé dans les années 80 par
Richard Stallman\footnote{\url{http://fr.wikipedia.org/wiki/Richard_Stallman}}.
Ces logiciels libres proviennent en grande partie du projet \lien{GNU}{http://www.gnu.org/home.fr.html}, lancé dans les années 80 par
\lien{Richard Stallman}{http://fr.wikipedia.org/wiki/Richard\_Stallman}.

%Image de Gnu
\illust{images/GNU.jpeg}{0.3}{Un gnou en lévitation, symbole du projet GNU}
\illust{GNU}{0.3}{Un gnou en lévitation, symbole du projet GNU}
\label{logo GNU}

Il manquait un noyau\footnote{\url{http://fr.wikipedia.org/wiki/Noyau_Linux}} au projet GNU pour fonctionner, ce qu'apportera Linus Torvalds\footnote{\url{http://fr.wikipedia.org/wiki/Linus_Torvalds}}
Il manquait un \lien{noyau}{http://fr.wikipedia.org/wiki/Noyau\_Linux} au projet GNU pour fonctionner, ce qu'apportera
\lien{Linus Torvalds}{http://fr.wikipedia.org/wiki/Linus\_Torvalds}
, un étudiant finlandais, avec le noyau Linux, dans les années 90.

%Image de tux

\illust{images/tux.png}{0.3}{Tux est un manchot, la mascotte de Linux}
\illust{tux}{0.3}{Tux est un manchot, la mascotte de Linux}
L'ensemble est donc nommé \emph{GNU/Linux}.
\section{Organisation}
@@ -38,32 +39,37 @@ Le système d'exploitation (distribution) Debian, est décliné en trois version
\end{itemize}
%Image Logo Debian
\illust{images/logodebian.png}{0.3}{Le logo de Debian}
\illust{logodebian}{0.3}{Le logo de Debian}
\label{logo debian}

\chapter{Debian sur son ordinateur}
\section{Se procurer Debian}
\begin{enumerate}
\item Par téléchargement gratuit sur le site officiel\footnote{Site officiel Debian : \url{http://www.debian.org/distrib/}}.
\item Par téléchargement gratuit sur \lien{le site officiel}{http://www.debian.org/distrib/}.
\item Chez votre marchand de journaux, les magazines informatiques Linux proposent régulièrement des CD de Debian.
\item L'acheter sur internet, certains sites\footnote{ Par exemple : \url{http://linuxcd.org/}} proposent de vous envoyer un CD Debian par courrier.
\item En vous rapprochant d'un groupe d'utilisateurs Linux de votre région qui vous aidera\footnote{Liste des GUL : \url{http://aful.org/gul/liste}}.
\item L'acheter sur internet, \lien{certains sites}{http://linuxcd.org/}
proposent de vous envoyer un CD Debian par courrier.
\item En vous rapprochant d'un \lien{groupe d'utilisateurs}{http://aful.org/gul/liste}
Linux de votre région qui vous aidera.
\end{enumerate}
\section{Essayer Debian sans rien installer}
On peut tester Debian en démarrant l'ordinateur à partir d'un CD ou d'une clé usb\footnote{\url{http://wiki.debian-facile.org/tuto:ebook_pour_debutant_qui_debute_unetbootin}} sans aucune modification sur son PC avec un Live-CD (ou live-usb).
On peut tester Debian en démarrant l'ordinateur à partir d'un CD ou d'une \lien{clé usb}
{http://wiki.debian-facile.org/tuto:ebook\_pour\_debutant\_qui\_debute\_unetbootin} sans aucune modification sur son PC avec un Live-CD (ou live-usb).
Ce même CD (ou clé usb) vous servira à installer Debian si vous le souhaitez.
\illust{images/live.png}{0.5}{Lancer Debiansans l'installer sur votre disque dur}
\illust{live}{0.5}{Lancer Debiansans l'installer sur votre disque dur}

\section{Debian sur votre disque dur}
Debian dispose d'un installateur en mode graphique qui vous guide tout au long des étapes de l'installation\footnote{\url{http://wiki.debian-facile.org/manuel:installion}}.
Debian dispose d'un installateur en mode graphique qui vous guide tout au long des étapes de
\lien{l'installation}{http://wiki.debian-facile.org/manuel:installion}.

%Image Installateur graphique
\illust{images/installateur.png}{0.5}{L'installateur graphique de Debian en action}
\illust{installateur}{0.5}{L'installateur graphique de Debian en action}
\label{image installateur graphique}
Il est tout a fait possible d'installer Debian sur votre disque dur à coté d'un autre système d'exploitation\footnote{\url{http://wiki.debian-facile.org/tuto:installation_dual-boot}}.
Il est tout a fait possible d'installer Debian sur votre disque dur à coté d'un autre
\lien{système d'exploitation}{http://wiki.debian-facile.org/tuto:installation\_dual-boot}.
Vous choisissez au démarrage quel système lancer. Il est même possible de partager des données (documents, mails, marque-pages de navigateur internet) entre ces deux systèmes.
\illust{images/grub.png}{0.5}{Grub, vous permet de choisir entre plusieurs sutème d'exploitation au démarrage de l'ordinateur}
\illust{grub}{0.5}{Grub, vous permet de choisir entre plusieurs sutème d'exploitation au démarrage de l'ordinateur}
\label{grub}

\chapter{Debian, c'est adaptable, c'est simple, c'est stable, c'est sécurisé}
@@ -71,15 +77,15 @@ Vous choisissez au démarrage quel système lancer. Il est même possible de par
Différents environnements de bureau peuvent être installés. Chacun d'eux a ses spécificités et nécessite plus ou moins de ressources (mémoire, vitesse du processeur …). Cela permet à Debian de s'adapter à vos besoins et à la puissance de votre ordinateur.

Nous vous présentons ici les 4 environnements de bureau les plus utilisés : Gnome, KDE, XFCE et LXDE.
\illust{images/gnome2.jpeg}{0.7}{Le bureau Gnome, ergonomique et configurable}
\illust{gnome2}{0.7}{Le bureau Gnome, ergonomique et configurable}
\label{illustration gnome}
\illust{images/kde.png}{0.7}{le bureau KDE, puissant et élégant}
\illust{kde}{0.7}{le bureau KDE, puissant et élégant}
\label{illustration KDE}
\illust{images/xfce.png}{0.7}{Le bureau XFCE, simple et leger}
\label{images/llustration xfce}
\illust{images/lxde.png}{0.7}{Le bureau LXDE,ultra-leger}
\illust{xfce}{0.7}{Le bureau XFCE, simple et leger}
\label{llustration xfce}
\illust{lxde}{0.7}{Le bureau LXDE,ultra-leger}
\label{illustration lxde}
Il existe encore d'autres environnements de bureau\footnote{\url{http://wiki.debian-facile.org/\#environnements_graphiques_gnu_linux}}.
Il existe encore d'autres \lien{environnements de bureau}{http://wiki.debian-facile.org/\#environnements\_graphiques\_gnu\_linux}.

\section{Une multitude de logiciel}
@@ -88,11 +94,12 @@ Debian dispose d'environ 29 000 logiciels prêt à être installés. On peut don
Ces logiciels sont disponibles sur le serveur de Debian, longuement vérifiés et testés (pour la version stable) par des milliers de bénévoles afin d'éliminer la majorité des bugs.

L'installation peut se faire en mode graphique ou en mode console.\\
\fcolorbox{black}{boite}{\begin{minipage}[c]{\textwidth}L'utilisation de ces installateurs vous permet d'être certain que chaque composant du logiciel que vous installez est parfaitement adapté à votre système. Il est donc garantie que le logiciel installé fonctionne.
\end{minipage}}
\illust{images/logitheque.png}{0.5}{Logithèque, un installateur de logiciel graphique du bureau Gnome.}
\begin{tip}
L'utilisation de ces installateurs vous permet d'être certain que chaque composant du logiciel que vous installez est parfaitement adapté à votre système. Il est donc garantie que le logiciel installé fonctionne.
\end{tip}
\illust{logitheque}{0.5}{Logithèque, un installateur de logiciel graphique du bureau Gnome.}
\label{illustration logitheque}
\illust{images/console.png}{0.5}{Aptitude : l'installateur en mode console.}
\illust{console}{0.5}{Aptitude : l'installateur en mode console.}
\label{illustration aptitude}

\section{La sécurité et la stabilité}
@@ -108,11 +115,16 @@ Sous Debian, les disques dur ne se fragmentent pas. Pas de ralentissement intemp

\chapter{Besoin d'aide : Debian, une forte communauté}
\section{Sur Debian-Facile}
\paragraph{La FAQ spécial grand débutant qui débute de debian-Facile : }\url{http://wiki.debian-facile.org/tuto:ebook_pour_debutant_qui_debute_faq}
\paragraph{Le wiki Debian-facile : }\url{http://wiki.debian-facile.org/}
\begin{itemize}
\item \lien{La FAQ spécial grand débutant qui débute de debian-Facile}{http://wiki.debian-facile.org/tuto:ebook\_pour\_debutant\_qui\_debute\_faq}
\item \lien{Le wiki Debian-facile}{http://wiki.debian-facile.org/}
\end{itemize}
\section{Un guide complet sur Debian stable}
\paragraph{La Formation Debian GNU/Linux : }\url{http://formation-debian.via.ecp.fr/}
\lien{La Formation Debian GNU/Linux}{http://formation-debian.via.ecp.fr/}
\section{Le site officiel du projet Debian}
\paragraph{La Foire Aux Questions Debian GNU/Linux : }\url{http://www.debian.org/doc/manuals/debian-faq/}
\paragraph{La documentation officielle Debian dans son ensemble : }{\url{http://www.debian.org/doc/}
\paragraph{Le site officiel Debian.org : }\url{http://www.debian.org/index.fr.html}
\begin{itemize}
\item \lien{La Foire Aux Questions Debian GNU/Linux}{http://www.debian.org/doc/manuals/debian-faq/}
\item \lien{La documentation officielle Debian dans son ensemble}{http://www.debian.org/doc/}
\item \lien{Le site officiel Debian.org}{http://www.debian.org/index.fr.html}
\end{itemize}

+ 25
- 0
src/ebook-facile.sty View File

@@ -0,0 +1,25 @@
%Définition d'une boite tip
\newenvironment{tip}{%
\definecolor{shadecolor}{RGB}{221, 255, 221}
\begin{shaded}\includegraphics[width=20mm]{ampoule}}
{\end{shaded}}

%Definition d'une illustration Utilisation \illust{fichier/image}{echelle par rapport à la largeur du texte ex:0.5}{Legende}
%L'image est centrée et la légende mise en dessous en petit et en italique.
\newcommand{\illust}[3]{\begin{center}\includegraphics[width=#2\textwidth]{{#1}}\nopagebreak[4]\\ \textit{\small{#3}}\end{center}}

%Traitement différent si on construit un pdf ou non, en particulier pour l'insertion des images.
\usepackage{ifpdf}
\ifpdf{}
\usepackage{graphicx}
\graphicspath{{images/}}
\usepackage[pdftex,hyperindex,colorlinks=true,linkcolor=black,urlcolor=blue,pdfstartview=FitH]{hyperref}
\else{}
\usepackage{hyperref}
\usepackage[dvips]{graphicx}
\graphicspath{{images/ps/}}
\fi

%Définition d'un lien. Premier paramètre, le texte affiché. Deuxième paramètre, l'url à mettre en lien.
%On pourrait par exemple avec cette commande \newcommand{\lien}[2]{\href{#2}{#1}} mettre le lien en lien hypertexte classique et non en note de bas de page.
\newcommand{\lien}[2]{#1\footnote{\url{#2}}}

+ 5
- 8
src/ebook-facile.tex View File

@@ -4,24 +4,21 @@
% Definition des Packages utilisés
\usepackage[utf8]{inputenc}
\usepackage[francais]{babel}
\usepackage{graphicx}
\usepackage{titlepic}
\usepackage{url}
\usepackage{xcolor}
\usepackage[pdftex,colorlinks=true,linkcolor=black,urlcolor=blue,pdfstartview=FitH]{hyperref}

%Definition d'une illustration Utilisation \illust{fichier/image}{echelle par rapport à la largeur du texte ex:0.5}{Legende}
%L'image est centrée et la légende mise en dessous en petit et en italique.
\newcommand{\illust}[3]{\begin{center}\includegraphics[width=#2\textwidth]{{#1}}\\ \textit{\small{#3}}\end{center}}
\usepackage{framed}
\usepackage{ebook-facile}

%Définnition des marges
\usepackage[top=5cm, bottom=5cm, left=3cm, right=3cm]{geometry}
\usepackage[top=2cm, bottom=2cm, left=2cm, right=2cm]{geometry}

%Information de la page de garde
\title{Le livre du Grand Débutant qui Débute}
\author{Debian-Facile}
\date{\today}
\titlepic{\includegraphics[width=0.5\textwidth]{images/dftitia.png}} %Insère une image sur la page de garde
\titlepic{\includegraphics[width=0.5\textwidth]{dftitia}} %Insère une image sur la page de garde





+ 548
- 0
src/framed.sty View File

@@ -0,0 +1,548 @@
% framed.sty v 0.96 2011/10/22
% Copyright (C) 1992-2011 by Donald Arseneau (asnd@triumf.ca)
% These macros may be freely transmitted, reproduced, or modified
% for any purpose provided that this notice is left intact.
%
%====================== Begin Instructions =======================
%
% framed.sty
% ~~~~~~~~~~
% Create framed, shaded, or differently highlighted regions that can
% break across pages. The environments defined are
% framed - ordinary frame box (\fbox) with edge at margin
% oframed - framed with open top/bottom at page breaks
% shaded - shaded background (\colorbox) bleeding into margin
% shaded* - shaded background (\colorbox) with edge at margin
% snugshade - shaded with tight fit around text (esp. in lists)
% snugshade* - like snugshade with shading edge at margin
% leftbar - thick vertical line in left margin
%
% to be used like
% \begin{framed}
% copious text
% \end{framed}
%
% But the more general purpose of this package is to facilitate the
% definition of new environments that take multi-line material,
% wrap it with some non-breakable formatting (some kind of box or
% decoration) and allow page breaks in the material. Such environments
% are defined to declare (or use) \FrameCommand for applying the boxy
% decoration, and \MakeFramed{settings} ... \endMakeFramed wrapped
% around the main text argument (environment body).
%
% The "framed" environment uses "\fbox", by default, as its "\FrameCommand"
% with the additional settings "\fboxrule=\FrameRule" and "\fboxsep=\FrameSep".
% You can change these lengths (using "\setlength") and you can change
% the definition of "\FrameCommand" to use much fancier boxes.
%
% In fact, the "shaded" environment just redefines \FrameCommand to be
% "\colorbox{shadecolor}" (and you have to define the color `"shadecolor"':
% "\definecolor{shadecolor}...").
%
% Although the intention is for other packages to define the varieties
% of decoration, a command "\OpenFbox" is defined for frames with open
% tops or bottoms, and used for the "oframed" environment. This facility
% is based on a more complex and capable command "\CustomFBox" which can
% be used for a wider range of frame styles. One such style of a title-bar
% frame with continuation marks is provided as an example. It is used by
% the "titled-frame" environment. To make use of "titled-frame" in your
% document, or the "\TitleBarFrame" command in your own environment
% definitions, you must define the colors TFFrameColor (for the frame)
% and a contrasting TFTitleColor (for the title text).
%
% A page break is allowed, and even encouraged, before the framed
% environment. If you want to attach some text (a box title) to the
% frame, then the text should be inserted by \FrameCommand so it cannot
% be separated from the body.
%
% The contents of the framed regions are restricted:
% Floats, footnotes, marginpars and head-line entries will be lost.
% (Some of these may be handled in a later version.)
% This package will not work with the page breaking of multicol.sty,
% or other systems that perform column-balancing.
%
% The MakeFramed environment does the work. Its `settings' argument
% should contain any adjustments to the text width (via a setting of
% "\hsize"). Here, the parameter "\width" gives the measured extra width
% added by the frame, so a common setting is "\advance\hsize-\width"
% which reduces the width of the text just enough that the outer edge
% of the frame aligns with the margins. The `settings' should also
% include a `restore' command -- "\@parboxrestore" or "\FrameRestore"
% or something similar; for instance, the snugshade environment uses
% settings to eliminate list indents and vertical space, but uses
% "\hspace" in "\FrameCommand" to reproduce the list margin ouside the
% shading.
%
% There are actually four variants of "\FrameCommand" to allow different
% formatting for each part of an environment broken over pages. Unbroken
% text is adorned by "\FrameCommand", whereas split text first uses
% "\FirstFrameCommand", possibly followed by "\MidFrameCommand", and
% finishing with "\LastFrameCommand". The default definitions for
% these three just invokes "\FrameCommand", so that all portions are
% framed the same way. See the oframe environment for use of distinct
% First/Mid/Last frames.
%
% Expert commands:
% \MakeFramed, \endMakeFramed: the "MakeFramed" environment
% \FrameCommand: command to draw the frame around its argument
% \FirstFrameCommand: the frame for the first part of a split environment
% \LastFrameCommand: for the last portion
% \MidFrameCommand: for any intermediate segments
% \FrameRestore: restore some text settings, but fewer than \@parboxrestore
% \FrameRule: length register; \fboxrule for default "framed".
% \FrameSep: length register; \fboxsep for default "framed".
% \FrameHeightAdjust: macro; height of frame above baseline at top of page
% \OuterFrameSep: vertical space before and after the framed env. Defaults to "\topsep"
%
% This is still a `pre-production' version because I can think of many
% features/improvements that should be made. Also, a detailed manual needs
% to be written. Nevertheless, starting with version 0.5 it should be bug-free.
%
% ToDo:
% Test more varieties of list
% Improve and correct documentation
% Propagation of \marks
% Handle footnotes (how??) floats (?) and marginpars.
% Stretchability modification.
% Make inner contents height/depth influence placement.
%======================== End Instructions ========================

\ProvidesPackage{framed}[2011/10/22 v 0.96:
framed or shaded text with page breaks]

\newenvironment{framed}% using default \FrameCommand
{\MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}

\newenvironment{shaded}{%
\def\FrameCommand{\fboxsep=\FrameSep \colorbox{shadecolor}}%
\MakeFramed {\FrameRestore}}%
{\endMakeFramed}

\newenvironment{shaded*}{%
\def\FrameCommand{\fboxsep=\FrameSep \colorbox{shadecolor}}%
\MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}

\newenvironment{leftbar}{%
\def\FrameCommand{\vrule width 3pt \hspace{10pt}}%
\MakeFramed {\advance\hsize-\width \FrameRestore}}%
{\endMakeFramed}

% snugshde: Shaded environment that
% -- uses the default \fboxsep instead of \FrameSep
% -- leaves the text indent unchanged (shading bleeds out)
% -- eliminates possible internal \topsep glue (\@setminipage)
% -- shrinks inside the margins for lists
% An \item label will tend to hang outside the shading, thanks to
% the small \fboxsep.

\newenvironment{snugshade}{%
\def\FrameCommand##1{\hskip\@totalleftmargin \hskip-\fboxsep
\colorbox{shadecolor}{##1}\hskip-\fboxsep
% There is no \@totalrightmargin, so:
\hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
\MakeFramed {\advance\hsize-\width
\@totalleftmargin\z@ \linewidth\hsize
\@setminipage}%
}{\par\unskip\@minipagefalse\endMakeFramed}

\newenvironment{snugshade*}{%
\def\FrameCommand##1{\hskip\@totalleftmargin
\colorbox{shadecolor}{##1}%
% There is no \@totalrightmargin, so:
\hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}%
\MakeFramed {\advance\hsize-\width
\@totalleftmargin\z@ \linewidth\hsize
\advance\labelsep\fboxsep
\@setminipage}%
}{\par\unskip\@minipagefalse\endMakeFramed}

\newenvironment{oframed}{% open (top or bottom) framed
\def\FrameCommand{\OpenFBox\FrameRule\FrameRule}%
\def\FirstFrameCommand{\OpenFBox\FrameRule\z@}%
\def\MidFrameCommand{\OpenFBox\z@\z@}%
\def\LastFrameCommand{\OpenFBox\z@\FrameRule}%
\MakeFramed {\advance\hsize-\width \FrameRestore}%
}{\endMakeFramed}

% A simplified entry to \CustomFBox with two customized parameters:
% the thicknesses of the top and bottom rules. Perhaps we want to
% use less \fboxsep on the open edges?

\def\OpenFBox#1#2{\fboxsep\FrameSep
\CustomFBox{}{}{#1}{#2}\FrameRule\FrameRule}

% \CustomFBox is like an amalgamation of \fbox and \@frameb@x,
% so it can be used by an alternate to \fbox or \fcolorbox, but
% it has more parameters for various customizations.
% Parameter #1 is inserted (in vmode) right after the top rule
% (useful for a title or assignments), and #2 is similar, but
% inserted right above the bottom rule.
% The thicknesses of the top, bottom, left, and right rules are
% given as parameters #3,#4,#5,#6 respectively. They should be
% \fboxrule or \z@ (or some other thickness).
% The text argument is #7.
% An instance of this can be used for the frame of \fcolorbox by
% locally defining \fbox before \fcolorbox; e.g.,
% \def\fbox{\CustomFBox{}{}\z@\z@\fboxrule\fboxrule}\fcolorbox
%
% Do we need to use different \fboxsep on different sides too?
%
\long\def\CustomFBox#1#2#3#4#5#6#7{%
\leavevmode\begingroup
\setbox\@tempboxa\hbox{%
\color@begingroup
\kern\fboxsep{#7}\kern\fboxsep
\color@endgroup}%
\hbox{%
% Here we calculate and shift for the depth. Done in
% a group because one of the arguments might be \@tempdima
% (we could use \dimexpr instead without grouping).
\begingroup
\@tempdima#4\relax
\advance\@tempdima\fboxsep
\advance\@tempdima\dp\@tempboxa
\expandafter\endgroup\expandafter
\lower\the\@tempdima\hbox{%
\vbox{%
\hrule\@height#3\relax
#1%
\hbox{%
\vrule\@width#5\relax
\vbox{%
\vskip\fboxsep % maybe these should be parameters too
\copy\@tempboxa
\vskip\fboxsep}%
\vrule\@width#6\relax}%
#2%
\hrule\@height#4\relax}%
}%
}%
\endgroup
}


% A particular type of titled frame with continuation marks.
% Parameter #1 is the title, repeated on each page.
\newenvironment{titled-frame}[1]{%
\def\FrameCommand{\fboxsep8pt\fboxrule2pt
\TitleBarFrame{\textbf{#1}}}%
\def\FirstFrameCommand{\fboxsep8pt\fboxrule2pt
\TitleBarFrame[$\blacktriangleright$]{\textbf{#1}}}%
\def\MidFrameCommand{\fboxsep8pt\fboxrule2pt
\TitleBarFrame[$\blacktriangleright$]{\textbf{#1\ (cont)}}}%
\def\LastFrameCommand{\fboxsep8pt\fboxrule2pt
\TitleBarFrame{\textbf{#1\ (cont)}}}%
\MakeFramed{\advance\hsize-20pt \FrameRestore}}%
% note: 8 + 2 + 8 + 2 = 20. Don't use \width because the frame title
% could interfere with the width measurement.
{\endMakeFramed}

% \TitleBarFrame[marker]{title}{contents}
% Frame with a label at top, optional continuation marker at bottom right.
% Frame color is TFFrameColor and title color is a contrasting TFTitleColor;
% both need to be defined before use. The frame itself use \fboxrule and
% \fboxsep. If the title is omitted entirely, the title bar is omitted
% (use a blank space to force a blank title bar).
%
\newcommand\TitleBarFrame[3][]{\begingroup
\ifx\delimiter#1\delimiter
\let\TF@conlab\@empty
\else
\def\TF@conlab{% continuation label
\nointerlineskip
\smash{\rlap{\kern\wd\@tempboxa\kern\fboxrule\kern\fboxsep #1}}}%
\fi
\let\TF@savecolor\current@color
\textcolor{TFFrameColor}{%
\CustomFBox
{\TF@Title{#2}}{\TF@conlab}%
\fboxrule\fboxrule\fboxrule\fboxrule
{\let\current@color\TF@savecolor\set@color #3}%
}\endgroup
}

% The title bar for \TitleBarFrame
\newcommand\TF@Title[1]{%
\ifx\delimiter#1\delimiter\else
\kern-0.04pt\relax
\begingroup
\setbox\@tempboxa\vbox{%
\kern0.8ex
\hbox{\kern\fboxsep\textcolor{TFTitleColor}{#1}\vphantom{Tj)}}%
\kern0.8ex}%
\hrule\@height\ht\@tempboxa
\kern-\ht\@tempboxa
\box\@tempboxa
\endgroup
\nointerlineskip
\kern-0.04pt\relax
\fi
}

\chardef\FrameRestore=\catcode`\| % for debug
\catcode`\|=\catcode`\% % (debug: insert space after backslash)

\newlength\OuterFrameSep \OuterFrameSep=\maxdimen \relax

\def\MakeFramed#1{\par
% apply default \OuterFrameSep = \topsep
\ifdim\OuterFrameSep=\maxdimen \OuterFrameSep\topsep \fi
% measure added width and height; call result \width and \height
\fb@sizeofframe\FrameCommand
\let\width\fb@frw \let\height\fb@frh
% insert pre-penalties and skips
\begingroup
\skip@\lastskip
\if@nobreak\else
\penalty9999 % updates \page parameters
\ifdim\pagefilstretch=\z@ \ifdim\pagefillstretch=\z@
% not infinitely stretchable, so encourage a page break here
\edef\@tempa{\the\skip@}%
\ifx\@tempa\zero@glue \penalty-30
\else \vskip-\skip@ \penalty-30 \vskip\skip@
\fi\fi\fi
\penalty\z@
% Give a stretchy breakpoint that will always be taken in preference
% to the \penalty 9999 used to update page parameters. The cube root
% of 10000/100 indicates a multiplier of 0.21545, but the maximum
% calculated badness is really 8192, not 10000, so the multiplier
% is 0.2301.
\advance\skip@ \z@ plus-.5\baselineskip
\advance\skip@ \z@ plus-.231\height
\advance\skip@ \z@ plus-.231\skip@
\advance\skip@ \z@ plus-.231\OuterFrameSep
\vskip-\skip@ \penalty 1800 \vskip\skip@
\fi
\addvspace{\OuterFrameSep}%
\endgroup
% clear out pending page break
\penalty\@M \vskip 2\baselineskip \vskip\height
\penalty9999 \vskip -2\baselineskip \vskip-\height
\penalty9999 % updates \pagetotal
|\message{After clearout, \pagetotal=\the\pagetotal, \pagegoal=\the\pagegoal. }%
\fb@adjheight
\setbox\@tempboxa\vbox\bgroup
#1% Modifications to \hsize (can use \width and \height)
\textwidth\hsize \columnwidth\hsize
}

\def\endMakeFramed{\par
\kern\z@
\hrule\@width\hsize\@height\z@ % possibly bad
\penalty-100 % (\hrule moves depth into height)
\egroup
%%% {\showoutput\showbox\@tempboxa}%
\begingroup
\fb@put@frame\FrameCommand\FirstFrameCommand
\endgroup
\@minipagefalse % In case it was set and not cleared
}

% \fb@put@frame takes the contents of \@tempboxa and puts all, or a piece,
% of it on the page with a frame (\FrameCommand, \FirstFrameCommand,
% \MidFrameCommand, or \LastFrameCommand). It recurses until all of
% \@tempboxa has been used up. (\@tempboxa must have zero depth.)
% #1 = attempted framing command, if no split
% #2 = framing command if split
% First iteration: Try to fit with \FrameCommand. If it does not fit,
% split for \FirstFrameCommand.
% Later iteration: Try to fit with \LastFrameCommand. If it does not
% fit, split for \MidFrameCommand.
\def\fb@put@frame#1#2{\relax
\ifdim\pagegoal=\maxdimen \pagegoal\vsize \fi
| \message{=============== Entering putframe ====================^^J
| \pagegoal=\the\pagegoal, \pagetotal=\the\pagetotal. }%
\ifinner
\fb@putboxa#1%
\fb@afterframe
\else
\dimen@\pagegoal \advance\dimen@-\pagetotal % natural space left on page
\ifdim\dimen@<2\baselineskip % Too little room on page
| \message{Page has only \the\dimen@\space room left; eject. }%
\eject \fb@adjheight \fb@put@frame#1#2%
\else % there's appreciable room left on the page
\fb@sizeofframe#1%
| \message{\string\pagetotal=\the\pagetotal,
| \string\pagegoal=\the\pagegoal,
| \string\pagestretch=\the\pagestretch,
| \string\pageshrink=\the\pageshrink,
| \string\fb@frh=\the\fb@frh. \space}
| \message{^^JBox of size \the\ht\@tempboxa\space}%
\begingroup % temporarily set \dimen@ to be...
\advance\dimen@.8\pageshrink % maximum space available on page
\advance\dimen@-\fb@frh\relax % max space available for frame's contents
%%% LOOKS SUBTRACTED AND ADDED, SO DOUBLE ACCOUNTING!
\expandafter\endgroup
% expand \ifdim, then restore \dimen@ to real room left on page
\ifdim\dimen@>\ht\@tempboxa % whole box does fit
| \message{fits in \the\dimen@. }%
% ToDo: Change this to use vsplit anyway to capture the marks
% MERGE THIS WITH THE else CLAUSE!!!
\fb@putboxa#1%
\fb@afterframe
\else % box must be split
| \message{must be split to fit in \the\dimen@. }%
% update frame measurement to use \FirstFrameCommand or \MidFrameCommand
\fb@sizeofframe#2%
\setbox\@tempboxa\vbox{% simulate frame and flexiblity of the page:
\vskip \fb@frh \@plus\pagestretch \@minus.8\pageshrink
\kern137sp\kern-137sp\penalty-30
\unvbox\@tempboxa}%
\edef\fb@resto@set{\boxmaxdepth\the\boxmaxdepth
\splittopskip\the\splittopskip}%
\boxmaxdepth\z@ \splittopskip\z@
| \message{^^JPadded box of size \the\ht\@tempboxa\space split to \the\dimen@}%
% Split box here
\setbox\tw@\vsplit\@tempboxa to\dimen@
| \toks99\expandafter{\splitfirstmark}%
| \toks98\expandafter{\splitbotmark}%
| \message{Marks are: \the\toks99, \the\toks98. }%
\setbox\tw@\vbox{\unvbox\tw@}% natural-sized
| \message{Natural height of split box is \the\ht\tw@, leaving
| \the\ht\@tempboxa\space remainder. }%
% If the split-to size > (\vsize-\topskip), then set box to full size.
\begingroup
\advance\dimen@\topskip
\expandafter\endgroup
\ifdim\dimen@>\pagegoal
| \message{Frame is big -- Use up the full column. }%
\dimen@ii\pagegoal
\advance\dimen@ii -\topskip
\advance\dimen@ii \FrameHeightAdjust\relax
\else % suspect this is implemented incorrectly:
% If the split-to size > feasible room_on_page, rebox it smaller.
\advance\dimen@.8\pageshrink
\ifdim\ht\tw@>\dimen@
| \message{Box too tall; rebox it to \the\dimen@. }%
\dimen@ii\dimen@
\else % use natural size
\dimen@ii\ht\tw@
\fi
\fi
% Re-box contents to desired size \dimen@ii
\advance\dimen@ii -\fb@frh
\setbox\tw@\vbox to\dimen@ii \bgroup
% remove simulated frame and page flexibility:
\vskip -\fb@frh \@plus-\pagestretch \@minus-.8\pageshrink
\unvbox\tw@ \unpenalty\unpenalty
\ifdim\lastkern=-137sp % whole box went to next page
| \message{box split at beginning! }%
% need work here???
\egroup \fb@resto@set \eject % (\vskip for frame size was discarded)
\fb@adjheight
\fb@put@frame#1#2% INSERTED ???
\else % Got material split off at the head
\egroup \fb@resto@set
\ifvoid\@tempboxa % it all fit after all
| \message{box split at end! }%
\setbox\@tempboxa\box\tw@
\fb@putboxa#1%
\fb@afterframe
\else % it really did split
| \message{box split as expected. Its reboxed height is \the\ht\tw@. }%
\ifdim\wd\tw@>\z@
\wd\tw@\wd\@tempboxa
\centerline{#2{\box\tw@}}% ??? \centerline bad idea
\else
| \message{Zero width means likely blank. Don't frame it (guess)}%
\box\tw@
\fi
\hrule \@height\z@ \@width\hsize
\eject
\fb@adjheight
\fb@put@frame\LastFrameCommand\MidFrameCommand
\fi\fi\fi\fi\fi
}

\def\fb@putboxa#1{%
\ifvoid\@tempboxa
\PackageWarning{framed}{Boxa is void -- discard it. }%
\else
| \message{Frame and place boxa. }%
| %{\showoutput\showbox\@tempboxa}%
\centerline{#1{\box\@tempboxa}}%
\fi
}

\def\fb@afterframe{%
\nointerlineskip \null %{\showoutput \showlists}
\penalty-30 \vskip\OuterFrameSep \relax
}

% measure width and height added by frame (#1 = frame command)
% call results \fb@frw and \fb@frh
% todo: a mechanism to handle wide frame titles
\newdimen\fb@frw
\newdimen\fb@frh
\def\fb@sizeofframe#1{\begingroup
\setbox\z@\vbox{\vskip-5in \hbox{\hskip-5in
#1{\hbox{\vrule \@height 4.7in \@depth.3in \@width 5in}}}%
\vskip\z@skip}%
| \message{Measuring frame addition for \string#1 in \@currenvir\space
| gives ht \the\ht\z@\space and wd \the\wd\z@. }%
| %{\showoutput\showbox\z@}%
\global\fb@frw\wd\z@ \global\fb@frh\ht\z@
\endgroup
}

\def\fb@adjheight{%
\vbox to\FrameHeightAdjust{}% get proper baseline skip from above.
\penalty\@M \nointerlineskip
\vskip-\FrameHeightAdjust
\penalty\@M} % useful for tops of pages

\edef\zero@glue{\the\z@skip}

\catcode`\|=\FrameRestore

% Provide configuration commands:
\providecommand\FrameCommand{%
\setlength\fboxrule{\FrameRule}\setlength\fboxsep{\FrameSep}%
\fbox}
\@ifundefined{FrameRule}{\newdimen\FrameRule \FrameRule=\fboxrule}{}
\@ifundefined{FrameSep} {\newdimen\FrameSep \FrameSep =3\fboxsep}{}
\providecommand\FirstFrameCommand{\FrameCommand}
\providecommand\MidFrameCommand{\FrameCommand}
\providecommand\LastFrameCommand{\FrameCommand}

% Height of frame above first baseline when frame starts a page:
\providecommand\FrameHeightAdjust{6pt}

% \FrameRestore has parts of \@parboxrestore, performing a similar but
% less complete restoration of the default layout. See how it is used in
% the "settings" argument of \MakeFrame. Though not a parameter, \hsize
% should be set to the desired total line width available inside the
% frame before invoking \FrameRestore.
\def\FrameRestore{%
\let\if@nobreak\iffalse
\let\if@noskipsec\iffalse
\let\-\@dischyph
\let\'\@acci\let\`\@accii\let\=\@acciii
% \message{FrameRestore:
% \@totalleftmargin=\the \@totalleftmargin,
% \rightmargin=\the\rightmargin,
% \@listdepth=\the\@listdepth. }%
% Test if we are in a list (or list-like paragraph)
\ifnum \ifdim\@totalleftmargin>\z@ 1\fi
\ifdim\rightmargin>\z@ 1\fi
\ifnum\@listdepth>\z@ 1\fi 0>\z@
% \message{In a list: \linewidth=\the\linewidth, \@totalleftmargin=\the\@totalleftmargin,
% \parshape=\the\parshape, \columnwidth=\the\columnwidth, \hsize=\the\hsize,
% \labelwidth=\the\labelwidth. }%
\@setminipage % snug fit around the item. I would like this to be non-global.
% Now try to propageate changes of width from \hsize to list parameters.
% This is deficient, but a more advanced way to indicate modification to text
% dimensions is not (yet) provided; in particular, no separate left/right
% adjustment.
\advance\linewidth-\columnwidth \advance\linewidth\hsize
\parshape\@ne \@totalleftmargin \linewidth
\else % Not in list
\linewidth=\hsize
%\message{No list, set \string\linewidth=\the\hsize. }%
\fi
\sloppy
}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

BIN
src/images/ampoule.png View File

Before After
Width: 256  |  Height: 256  |  Size: 34 KiB

Loading…
Cancel
Save