summaryrefslogtreecommitdiff
path: root/macros/luatex/latex/letgut/source/letgut.org
diff options
context:
space:
mode:
Diffstat (limited to 'macros/luatex/latex/letgut/source/letgut.org')
-rw-r--r--macros/luatex/latex/letgut/source/letgut.org199
1 files changed, 182 insertions, 17 deletions
diff --git a/macros/luatex/latex/letgut/source/letgut.org b/macros/luatex/latex/letgut/source/letgut.org
index 11bd545dec..b4244888a2 100644
--- a/macros/luatex/latex/letgut/source/letgut.org
+++ b/macros/luatex/latex/letgut/source/letgut.org
@@ -22,21 +22,186 @@
#+PROPERTY: header-args :padline no :tangle letgut.cls :exports both :noweb yes :eval always
#+export_file_name: letgut-code
+* Ctanomat file :noexport:
+
+We crete here a ~ctanomat~ description file in order to simplify the upload of
+new versions of the class on CTAN.
+
+#+begin_src markdown :tangle letgut.pkg
+ % This is a description file for ctan-o-mat.
+ % It manages uploads of a package to
+ % CTAN -- the Comprehensive TeX Archive Network.
+ %
+ % The syntax is roughly oriented towards (La)TeX.
+ % Two form of the macros are used. The simple macros take one argument
+ % in braces. Here the argument may not contain embedded macros.
+ %
+ % The second form uses an environment enclosed in \begin{}/\end{}.
+ % In the long text fields logo macros can be used.
+ %
+ % You should enter your values between the begin and the end of the
+ % named type.
+ % -------------------------------------------------------------------------
+ % This field contains the CTAN id of the package.
+ % The value is optional.
+ % The value is restricted to 32 characters.
+ \pkg{letgut}
+ % -------------------------------------------------------------------------
+ % This field contains the version of the package.
+ % The value is optional.
+ % The value is restricted to 32 characters.
+ \version{0.9.1 2022-03-22}
+ % -------------------------------------------------------------------------
+ % This field contains the name of the author(s).
+ % The value is optional.
+ % The value is restricted to 128 characters.
+ \author{Association GUTenberg}
+ % -------------------------------------------------------------------------
+ % This field contains the email address of the uploader.
+ % The value is an email address.
+ % The value is restricted to 255 characters.
+ \email{secretariat@gutenberg.eu.org}
+ % -------------------------------------------------------------------------
+ % This field contains the name of the uploader.
+ % The value is restricted to 255 characters.
+ \uploader{Denis Bitouzé}
+ % -------------------------------------------------------------------------
+ % This field contains the directory on CTAN.
+ % The value is optional.
+ % The value is restricted to 255 characters.
+ \ctanPath{/macros/luatex/latex/letgut}
+ % -------------------------------------------------------------------------
+ % This field contains the license.
+ % The value is optional.
+ % The value is restricted to 2048 characters.
+ % Multiple values are allowed.
+ \license{lppl1.3c}
+ % -------------------------------------------------------------------------
+ % This field contains the URL of the home page.
+ % The value is optional.
+ % The value is a URL.
+ % The value is restricted to 255 characters.
+ % Multiple values are allowed.
+ \home{}
+ % -------------------------------------------------------------------------
+ % This field contains the URL of the bug tracker.
+ % The value is optional.
+ % The value is a URL.
+ % The value is restricted to 255 characters.
+ % Multiple values are allowed.
+ \bugtracker{https://framagit.org/gutenberg/classe-lettre-gut/-/issues}
+ % -------------------------------------------------------------------------
+ % This field contains the support channel.
+ % The value is optional.
+ % The value is a URL.
+ % The value is restricted to 255 characters.
+ % Multiple values are allowed.
+ \support{}
+ % -------------------------------------------------------------------------
+ % This field contains the version management.
+ % The value is optional.
+ % The value is a URL.
+ % The value is restricted to 255 characters.
+ % Multiple values are allowed.
+ \repository{https://framagit.org/gutenberg/classe-lettre-gut/}
+ % -------------------------------------------------------------------------
+ % This field contains the developer's channel.
+ % The value is optional.
+ % The value is a URL.
+ % The value is restricted to 255 characters.
+ % Multiple values are allowed.
+ \development{https://framagit.org/gutenberg/classe-lettre-gut/-/merge_requests}
+ % -------------------------------------------------------------------------
+ % This field contains the update indicator; true for update.
+ % The value is optional.
+ % The value is restricted to 8 characters.
+ \update{true}
+ % -------------------------------------------------------------------------
+ % This field contains the topics id.
+ % The value is optional.
+ % The value is restricted to 1024 characters.
+ % Multiple values are allowed.
+ \topic{}
+ % -------------------------------------------------------------------------
+ % This field contains the text for the mail announcement.
+ % The value is optional.
+ % The value is restricted to 8192 characters.
+ \begin{announcement}
+ \end{announcement}
+ % -------------------------------------------------------------------------
+ % This field contains the one-liner for the package.
+ % The value is optional.
+ % The value is restricted to 128 characters.
+ \summary{Class for the newsletter “La Lettre GUTenberg” of the French TeX User Group GUTenberg}
+ % -------------------------------------------------------------------------
+ % This field contains the descriptive abstract for the package.
+ % The value is optional.
+ % The value is restricted to 4096 characters.
+ \begin{description}
+ # English
+
+ The French TeX User Group GUTenberg has been publishing “The GUTenberg Letter”,
+ its irregular newsletter, since February 1993.
+
+ For this purpose, a dedicated, in-house (La)TeX class was gradually created but,
+ depending on new needs and on the people who were publishing the Newsletter, its
+ development was somewhat erratic; in particular, it would not have been possible
+ to publish its code as it was. In addition, its documentation was non-existent.
+
+ The Board of Directors of the association, elected in November 2020, wished to
+ provide a better structured, more perennial and documented class, able to be
+ published on the CTAN. This is now done with the present `letgut` class.
+
+ # French
+
+ L'association GUTenberg publie « La Lettre GUTenberg », son bulletin
+ irrégulomestriel, depuis février 1993.
+
+ Pour ce faire, une classe (La)TeX dédiée, maison, a peu à peu vu le jour mais,
+ au gré des nouveaux besoins et des personnes qui ont assuré la publication de la
+ Lettre, son développement a été quelque peu erratique ; il n'aurait notamment
+ pas été possible de publier son code en l'état. En outre, sa documentation était
+ inexistante.
+
+ Le Conseil d'Administration de l'association, élu en novembre 2020, a souhaité
+ fournir une classe mieux structurée, davantage pérenne et documentée, à même
+ d'être publiée sur le CTAN. C'est désormais chose faite avec la présente classe
+ `letgut`.
+ \end{description}
+ % -------------------------------------------------------------------------
+ % This field contains the note to the CTAN upload managers.
+ % The value is optional.
+ % The value is restricted to 2048 characters.
+ \begin{note}
+ \end{note}
+ % -------------------------------------------------------------------------
+ % This field contains the archive file.
+ % The value is the file name of the archive to be uploaded.
+ % It may have a relative or absolute directory.
+ \file{../dtx-forge/letgut.zip}
+#+end_src
+
* Changelog file :noexport:
#+begin_src markdown :tangle CHANGELOG.md
-# Changelog
-All notable changes to this project will be documented in this file.
+ # Changelog
+ All notable changes to this project will be documented in this file.
+
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+ and this project adheres to [Semantic
+ Versioning](http://semver.org/spec/v2.0.0.html).
+
+ ## [Unreleased]
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic
-Versioning](http://semver.org/spec/v2.0.0.html).
+ ## [0.9.1] - 2022-03-22
-## [Unreleased]
+ ### Changed
+ File renamed (Karl Berry request)
-## [0.9] - 2022-03-18
+ ## [0.9] - 2022-03-18
-### Added First public testing release
+ ### Added
+ First public testing release
#+end_src
* Readme file :noexport:
@@ -52,7 +217,7 @@ to the newsletter “La Lettre GUTenberg” of GUTenberg, the French TeX User Gr
Release
-------
-2022-03-18 v0.9
+2022-03-22 v0.9.1
Development
-----------
@@ -182,8 +347,8 @@ Now, we can announce the class name and its version:
#+begin_src latex
\ProvidesExplClass{letgut}
- {2022-03-18}
- {0.9}
+ {2022-03-22}
+ {0.9.1}
{
Class~ for~ the~ newsletter~
“\c__letgut_La_lettre_gutenberg_tl”
@@ -2004,7 +2169,7 @@ We define the command that lets us specify the newsletter setup.
\NewDocumentCommand {\francophony} { } {
\raisebox{-1.5pt}{
\includegraphics[width=\f@size pt]{
- Flag_of_La_Francophonie-crop
+ letgut-francophony-icon
}
}
}
@@ -2556,7 +2721,7 @@ full name of the authors.
#+end_src
The keys options are created.
#+begin_src latex
- \keys_define:nn { gzt/bookreview }
+ \keys_define:nn { letgut/bookreview }
{
title .tl_gset:N = \g__letgut_bookreview_title_tl,
frontcover .tl_gset:N = \g__letgut_bookreview_frontcover_tl,
@@ -2582,7 +2747,7 @@ We create the new environment for the book reviews.
\cs_generate_variant:Nn \msg_error:nnnn { nnVV }
\NewDocumentEnvironment{bookreview}{ m }
{
- \keys_set:nn { gzt/bookreview } { #1 }
+ \keys_set:nn { letgut/bookreview } { #1 }
\section{\g__letgut_bookreview_title_tl}
\tl_if_empty:NTF \g__letgut_bookreview_frontcover_tl {
\msg_warning:nnV{letgut}{frontcover-missing}{
@@ -3037,7 +3202,7 @@ several purposes:
- the books advertisements.
#+begin_src latex :tangle letgut.lbx :exports both
- \ProvidesFile{letgut.lbx}[2022-03-18 v0.9 letgut localization]
+ \ProvidesFile{letgut.lbx}[2022-03-22 v0.9.1 letgut localization]
\InheritBibliographyExtras{french}
\DeclareBibliographyStrings{
inherit = {french},
@@ -3051,7 +3216,7 @@ several purposes:
create the corresponding new entry).
#+begin_src latex :tangle letgut.dbx :exports both
- \ProvidesFile{letgut.dbx}[2022-03-18 v0.9 letgut data model macros]
+ \ProvidesFile{letgut.dbx}[2022-03-22 v0.9.1 letgut data model macros]
\DeclareBibliographyDriver{bookreview}{%
\usebibmacro{bibindex}%
\usebibmacro{begentry}%
@@ -3106,7 +3271,7 @@ several purposes:
We provide a specific ~biblatex~ citation style .
#+begin_src latex :tangle letgut.cbx :exports both
- \ProvidesFile{letgut.cbx}[2022-03-18 v0.9 letgut base citation style]
+ \ProvidesFile{letgut.cbx}[2022-03-22 v0.9.1 letgut base citation style]
\RequireCitationStyle{numeric}
#+end_src