### Install Local Packages with l3build Source: https://github.com/latex3/latex3.github.io/blob/main/latex3/code/index.md After cloning a repository, navigate to the relevant directory (e.g., `l3kernel`) and use `l3build install` to locally install packages. This command is essential for testing development versions of LaTeX components. ```bash cd l3kernel l3build install ``` -------------------------------- ### Install Project Gems with Bundler Source: https://github.com/latex3/latex3.github.io/blob/main/README.md Installs the necessary Ruby gems for the LaTeX Project website development. Ensure you have bundler installed first by running `gem install bundler`. ```bash $ bundle install ``` -------------------------------- ### Example: Line Snapping with Grid and Movement Limits Source: https://github.com/latex3/latex3.github.io/blob/main/publications/2005-09-24-l3team-pdfTeX-meeting/alreadyexistingideasandapproaches.html Demonstrates setting line snapping to a grid with specified movement ranges. This example shows how \pdflinesnapy affects line alignment relative to a \pdfsnaprefpoint. ```tex \pdflinesnapy 10pt plus 5pt minus 4pt ``` -------------------------------- ### LaTeX Snapping Compensation Example Source: https://github.com/latex3/latex3.github.io/blob/main/publications/2005-09-24-l3team-pdfTeX-meeting/alreadyexistingideasandapproaches.html Example demonstrating the use of \pdfsnapycomp for proportional spacing around displayed math. It shows how \pdfsnapycomp and \pdfsnapy work together to distribute space. ```latex ,-------- |     | \vadjust{\pdfsnapycomp 500} |     $$ $$ |     \vadjust pre{\pdfsnapy \snapunit plus .8\snapunit minus .2\snapunit} |     \-------- ``` -------------------------------- ### Example Copyright and License Notice Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-2.md Include this notice in each file of your program to state the copyright holder and the licensing terms. Ensure it includes your name, the year, and a link to the LPPL. ```text %% pig.dtx %% Copyright 2001 M. Y. Name % % This program may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.2 % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.2 or later is part of all distributions of LaTeX % version 1999/12/01 or later. % % This program consists of the files pig.dtx and pig.ins ``` -------------------------------- ### Example: X-Direction Snap Node with Grid and Movement Source: https://github.com/latex3/latex3.github.io/blob/main/publications/2005-09-24-l3team-pdfTeX-meeting/alreadyexistingideasandapproaches.html Illustrates the usage of a pdf_snap_x_node with glue specifying the grid unit and movement limits for horizontal snapping. ```tex 5pt plus 4pt minus 3pt ``` -------------------------------- ### LaTeX Snapping Example Source: https://github.com/latex3/latex3.github.io/blob/main/publications/2005-09-24-l3team-pdfTeX-meeting/alreadyexistingideasandapproaches.html Example demonstrating the use of \pdfsnapy for aligning text around displayed math to a grid. It uses \vadjust pre to insert the node before the text line following the displayed math. ```latex ,-------- |     |     $$ $$ |     \vadjust pre{\pdfsnapy \snapunit plus .8\snapunit minus .2\snapunit} |     \-------- ``` -------------------------------- ### Example LPPL Notice in a LaTeX File Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-2.txt Include this notice in each file of your program to state that its distribution and modification are governed by the LPPL. Specify the license version and where to find it. ```tex %% pig.dtx %% Copyright 2001 M. Y. Name % % This program may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.2 % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.2 or later is part of all distributions of LaTeX % version 1999/12/01 or later. % % This program consists of the files pig.dtx and pig.ins ``` -------------------------------- ### Example Copyright and License Notice for a File Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-1.txt Include this notice in each file of your program to state copyright and specify that distribution and modification are governed by the LPPL. Ensure the correct license version and URL are referenced. ```tex %% pig.dtx %% Copyright 2001 M. Y. Name % % This program may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.1 % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.1 or later is part of all distributions of LaTeX % version 1999/06/01 or later. % % This program consists of the files pig.dtx and pig.ins ``` -------------------------------- ### Boolean Expression Example Source: https://github.com/latex3/latex3.github.io/blob/main/_includes/_papers/paper_2009-MHo-TUG-Consolidation-of-expl3.md This is a code example demonstrating boolean expressions within expl3. Refer to the linked PDF for context on its usage. ```tex \documentclass{article} \usepackage{expl3} \begin{document} % Example of boolean expression handling \ExplSyntaxOn \bool_set_true:N \l_my_bool_tl \bool_if_true:NTF \l_my_bool_tl { True branch } { False branch } \ExplSyntaxOff \end{document} ``` -------------------------------- ### Set Uploader Email via Command Line Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2019-04-16-l3build-upload.md Provide the uploader's email address directly on the command line using the --email option. ```bash l3build upload --email "my.email@mail.com" ... ``` -------------------------------- ### LaTeX Internal Character Representation Examples Source: https://github.com/latex3/latex3.github.io/blob/main/help/FAQ/utf8-inputenc.md Examples of how characters like 'é', 'ü', and 'ß' are represented in LaTeX's Internal Character Representation (LICR). ```latex \'e "u \ss ``` -------------------------------- ### Example LPPL Notice and Statement Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-3b.md This is an example of a copyright notice and statement required for files distributed under the LPPL. It specifies the license version, distribution conditions, and maintenance status. ```text %% pig.dtx %% Copyright 2005 M. Y. Name % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 % of this license or (at your option) any later version. % The latest version of this license is in % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of LaTeX % version 2005/12/01 or later. % % This work has the LPPL maintenance status `maintained'. % % The Current Maintainer of this work is M. Y. Name. % % This work consists of the files pig.dtx and pig.ins % and the derived file pig.sty. ``` -------------------------------- ### Run l3build Upload Command Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2019-04-16-l3build-upload.md Execute the l3build upload command after generating the package archive with `l3build ctan`. Use the --message flag for release notes. ```bash l3build upload --message "Minor update to fix some erroneous spaces from missing % signs" ``` -------------------------------- ### LPPL Notice and Statement Example Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-3c.txt This is an example of a copyright notice and statement to be included in a file when using the LaTeX Project Public License. It specifies the license version, distribution terms, and maintenance status. ```tex %% pig.dtx %% Copyright 2008 M. Y. Name % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 % of this license or (at your option) any later version. % The latest version of this license is in % https://www.latex-project.org/lppl.txt % and version 1.3c or later is part of all distributions of LaTeX % version 2008 or later. % % This work has the LPPL maintenance status `maintained'. % % The Current Maintainer of this work is M. Y. Name. % % This work consists of the files pig.dtx and pig.ins % and the derived file pig.sty. ``` -------------------------------- ### Serve Local Jekyll Site Source: https://github.com/latex3/latex3.github.io/blob/main/README.md Starts a local Jekyll development server to preview website changes. The site will be accessible at `http://localhost:4000`. Press `CTRL` + `C` to stop the server. ```bash $ jekyll serve ``` -------------------------------- ### LPPL Copyright Notice and Statement Example Source: https://github.com/latex3/latex3.github.io/blob/main/lppl/lppl-1-3c.md This example demonstrates the required copyright notice and license statement within a LaTeX component file (e.g., .dtx) to comply with the LPPL. It specifies the license version, location, and maintenance status. ```text %% pig.dtx %% Copyright 2005 M. Y. Name % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 % of this license or (at your option) any later version. % The latest version of this license is in % https://www.latex-project.org/lppl.txt % and version 1.3c or later is part of all distributions of LaTeX % version 2008 or later. % % This work has the LPPL maintenance status `maintained'. % % The Current Maintainer of this work is M. Y. Name. % % This work consists of the files pig.dtx and pig.ins % and the derived file pig.sty. ``` -------------------------------- ### Generate Generic Cross-Reference in LaTeX Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2023-11-04-issue38-of-latex2e-released.md Generate a generic cross-reference to a recorded property. This example retrieves the 'chapter' property associated with 'mylabel'. ```latex \RefProperty{mylabel}{chapter} ``` -------------------------------- ### Run xelatex with pre-release version Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2022-05-27-latex-dev-2022-2.md To test the pre-release version of LaTeX, append '-dev' to the xelatex command. ```bash xelatex-dev myfile ``` -------------------------------- ### Record Custom Properties in LaTeX Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2023-11-04-issue38-of-latex2e-released.md Record custom properties for a given label. This example shows recording 'chapter' and 'page' properties for 'mylabel'. ```latex \RecordProperties{mylabel}{chapter,page} ``` -------------------------------- ### Specify Release Notes via File Source: https://github.com/latex3/latex3.github.io/blob/main/_posts/2019-04-16-l3build-upload.md For longer release notes, use the --file option with l3build upload, pointing to a text file containing the notes. ```bash l3build upload --file releasenotes-v1.0c.txt ```