Skip to content

Commit

Permalink
docs: removal of obsolete hacks, sligh rewording, details
Browse files Browse the repository at this point in the history
  • Loading branch information
Omikhleia authored and Didier Willis committed Feb 26, 2023
1 parent b3dea57 commit f9db1ba
Show file tree
Hide file tree
Showing 5 changed files with 22 additions and 31 deletions.
12 changes: 5 additions & 7 deletions examples/lefevre-tuor-idril.sil
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
\begin[papersize=6in x 9in, class=resilient.book]{document}
\begin[papersize=6in x 9in, class=resilient.book, layout=demiluxe]{document}
\use[module=packages.url]
\use[module=packages.resilient.epigraph]
\style:define[name=epigraph-source]{}
Expand All @@ -8,15 +8,13 @@
%
\language[main=fr]
\font[family=Libertinus Serif]
\set[parameter=linebreak.emergencyStretch, value=15%lw]%
%
% HACKS/WORKAROUNDS FOR SILE 0.12.x BUGS
% FIXME \script[src=hacks/hacks]
% HACKS FOR SILE 0.14.2 BUGS???
\script{SILE.outputter:_ensureInit()}
% No longer required (bug in SILE 0.14.2
%\script{SILE.outputter:_ensureInit()}
%
% UGLY: We don't want URLs to be typeset using a typewriter font :)
% Just cancel the \code command so the default text font is used.
% Waiting for urlstyle in SILE code...
\define[command=code]{\process}%
%
\define[command=smallcaps]{\font[features=+smcp]{\process}}
Expand Down Expand Up @@ -62,7 +60,7 @@ end, "Wrapper around dropcap, for baselineskip adjustment")
\pdf:metadata[key=Title, value=Le conte perdu de Mercure]%
\pdf:metadata[key=Author, value=Alain Lefèvre]%

\begin{raggedright}
\begin{raggedright}%
Alain \smallcaps{Lefèvre}\footnote[mark=†]{Cet article est extrait de \em{Tolkien, le façonnement d’un monde}, \abbr:vol{1},
Le Dragon de Brume, 2011, \abbr:page{211–216} — avec la permission de l’auteur.}
\end{raggedright}
Expand Down
4 changes: 2 additions & 2 deletions examples/manual-classes/classes.sil
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
\begin{document}
\chapter{Book class}
\chapter{The resilient book class}

The design of the \strong{resilient.book} class was started as an attempt at gradually tuning the
default book class from SILE to this author’s needs and taste. It eventually
Expand Down Expand Up @@ -265,7 +265,7 @@ Cross-references are supported via the \autodoc:package{labelrefs} package, henc
the \autodoc:command{\label}, \autodoc:command{\ref} and \autodoc:command{\pageref} commands are
available.

\chapter{Curriculum vitae class}
\chapter{A \em{curriculum vitae} class}

The \strong{resilient.resume} class provides a minimalist (read, naive) way to make a modern \em{résumé} (CV) with SILE.

Expand Down
9 changes: 4 additions & 5 deletions examples/manual-prefaces/edition2.sil
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,11 @@ I expected my book project to be completed around March 2022, but the time-frame
shifted by a few months. Real-life constraints and proofreading sessions also
played a part… Let’s say, after all, that an extended 5- to 6-month charter was
actually required for the project to be achieved, with several hacks to circumvent
bug issues\footnote{%
bug issues and with a less bold layout than envisioned.\footnote{%
I got real annoyed to discover, that late in the process, that SILE couldn’t do
hyphenation properly and justify text correctly when fonts have ligatures…}
and with a less bold layout than envisioned\footnote{%
Not being able to use the so-said InDesign-like frames in any decent way was
one of the most painful learnings…}.
hyphenation properly and justify text correctly when fonts have ligatures…
Besides, not being able to use the so-said InDesign-like frames in any decent way
was one of the most painful learnings…}

Yet, the 362-page book was eventually
\href[src=https://sites.google.com/site/dragonbrumeux/contes-et-l%C3%A9gendes-dalmaq]{completed}\footnote{%
Expand Down
2 changes: 1 addition & 1 deletion examples/manual-styling/basics/concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ easier for class and package designers to abstract styling decisions,
by reusing the same mechanism in their own code, rather than reinventing
the wheel.

[^styles-vs-hooks]: Most "legacy" class classes and packages in SILE rely on hooks,
[^styles-vs-hooks]: Most "legacy" classes and packages in SILE rely on hooks,
such as `pullquote:font` and `book:right-running-head-font`, to quote just a few.
None of these seem to have the same type of name. Their scope too is not always
clear. What if one also wants, for instance, to specify a color? Of course,
Expand Down
26 changes: 10 additions & 16 deletions examples/manual.sil
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,6 @@
\use[module=packages.printoptions]
\language[main=en]
\font[family=Libertinus Serif, size=10pt]
% FIXME MAKE FONT SIZE, EMERG. AND SHAPER THE DEFAULT FOR RESILIENT
\set[parameter=linebreak.emergencyStretch, value=25%lw]
\set[parameter=shaper.spaceenlargementfactor, value=1]
\define[command=codeblock]{\font[family=Libertinus Sans]{\process}}
\footnote:rule
\header:rule
\pdf:metadata[key=Title, value=The resilient collection of classes & packages]
Expand All @@ -31,7 +27,7 @@ padding=2%fw, bordercolor=100, fillcolor=230, shadowcolor=#96A8C7, shadow=false]
\parbox[width=96%lw]{\set[parameter=document.parindent, value=0]\font[size=9pt]\color[color=100]{\process}\par}%
}}%
\medskip}
\set[parameter=textsubsuper.fake, value=true]% Broken see Houston below.
\set[parameter=textsubsuper.fake, value=true]

% We do not have a true titlepage for now, build it manually.
\background[color=#e9d8ba,allpages=false]
Expand All @@ -40,25 +36,23 @@ padding=2%fw, bordercolor=100, fillcolor=230, shadowcolor=#96A8C7, shadow=false]
\hbox{}\vfill

\begin{center}
\font[size=20pt]{The resilient collection
\font[size=20pt]{The

of classes & packages
\medskip
\font[size=35pt, style=italic]{\kern[width=-0.1em]re·sil·ient}

for SILE

}
\end{center}

\smallskip
\begin{center}
\font[size=16pt]{A redesigned version
collection

of

Omikhleia’s classes & packages
classes & packages

\smallskip
for SILE

}
\end{center}

\vfill

\break
Expand Down

0 comments on commit f9db1ba

Please sign in to comment.