Dear list,
I would like to give a brief update on the work I have been doing on the
ConTeXt Garden over the past few months.
This message is intended both for current subscribers to the list and as
a record in the archives for readers who may later encounter these pages.
On 18 July I reported a substantial revision of the Bibliography and
citations material. At that stage, the amount of information gathered on
the main page had made it increasingly difficult to distinguish
introductory material, practical examples, reference information,
explanations, and more advanced workflows.
Bruce Horrocks suggested that subdividing the material might help and
pointed me to Diátaxis, the documentation framework already used during
an earlier reorganization of the Garden. I have since applied that
approach more systematically, first to the bibliography material and
then to several related areas.
The general principle has been, where appropriate, to distinguish
between tutorials, how-to guides, reference material, and explanation;
to preserve useful existing material; to reduce duplication; and to link
related pages rather than repeat the same information in several places.
The main areas revised so far are:
1.
Bibliography and citations
2.
Footnotes and notes
3.
Registers and indexes
4.
Critical apparatus and scholarly editions
5.
Critical editions from TEI XML
6.
Languages, multilingual typesetting, RTL/BiDi, and fonts
The extent of the revision has varied considerably from one area to
another. Some pages have been substantially reorganized or rewritten,
while others have received more limited corrections, additions, updated
examples, or changes to their structure and navigation. The aim has not
been to impose a uniform rewrite, but to improve each part according to
its existing state and needs.
Each of these areas now has a main entry page or overview that provides
the structure of the topic and links to the relevant guides and related
material.
This revision has been part of a longer process carried out locally over
several months and progressively transferred to the Garden. Wherever
possible, MWEs have been compiled and checked locally and, where
appropriate, again through the Garden.
This has been especially important for examples inherited from older
MkIV documentation or from former beta versions. Statements about old
limitations, bugs, or workarounds should not simply be retained without
checking them against current LMTX.
The revised pages are not intended to be final. Each page that has been
revised carries a notice indicating that it has recently been worked on
and explicitly inviting volunteers to help correct, complete, test, or
otherwise improve its contents. These notices are meant to make clear
that the revision is an ongoing community effort rather than a finished
or closed piece of documentation. Technical corrections, additional
examples, alternative approaches, and other contributions are therefore
very welcome.
I would also like to thank all those who, directly or indirectly, have
contributed to this work through questions, MWEs, suggestions,
corrections, and discussions on the mailing list.
I should also make clear that this work has required a considerable
amount of time over the past months, and I do not expect to continue
revising Garden pages at the same rate. Future work will be more
occasional and will depend on particular questions, corrections, or needs.
The main entry points are listed below.
_References, notes, registers, and indexes_
Bibliography and citations
https://wiki.contextgarden.net/References_notes_and_floats/Bibliography_and_citations
Footnotes and notes
https://wiki.contextgarden.net/References_notes_and_floats/Footnotes
Registers and indexes
https://wiki.contextgarden.net/References_notes_and_floats/Registers_and_index
_Scholarly and critical editions_
Building a critical apparatus with ConTeXt
https://wiki.contextgarden.net/Building_a_critical_apparatus_with_ConTeXt
Building critical editions from TEI XML
https://wiki.contextgarden.net/Building_critical_editions_from_TEI_XML
_Languages and multilingual typesetting_
Languages
https://wiki.contextgarden.net/Input_and_compilation/Languages
These overview pages provide the detailed structure for each topic and
lead to the more specialized guides, examples, reference material, and
related pages.
Corrections, improvements, and suggestions are, of course, very welcome.
Best,
JP
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the
Wiki!
maillist : [email protected] /
https://mailman.ntg.nl/mailman3/lists/ntg-context.ntg.nl
webpage : https://www.pragma-ade.nl / https://context.aanhet.net (mirror)
archive : https://github.com/contextgarden/context
wiki : https://wiki.contextgarden.net
___________________________________________________________________________________
