CTAN Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/l3experimental

README.md

Ex­per­i­men­tal 3 Con­cepts

Re­lease 2018-10-17

Overview

The l3experimental pack­ages are a col­lec­tion of ex­per­i­men­tal im­ple­men­ta­tions for as­pects of the 3 ker­nel, deal­ing with higher-level ideas such as the De­signer In­ter­face. Some of them work as stand alone pack­ages, pro­vid­ing new func­tion­al­ity, and can be used on top of with no changes to the ex­ist­ing ker­nel. Others go fur­ther, and re­de­fine in­ter­nals to pro­vide bet­ter meth­ods for man­ag­ing cer­tain con­structs. The pack­ages in the col­lec­tion are un­der ac­tive de­vel­op­ment and the in­ter­faces may change.

All of the ma­te­rial in the col­lec­tion re­quires the 3 base layer pack­age l3kernel. The two pack­ages must be in­stalled in match­ing ver­sions: if you up­date l3experimental, make sure that l3kernel is up­dated at the same time.

Cur­rently in­cluded in the CTAN re­lease of l3­ex­per­i­men­tal are the fol­low­ing bun­dles:

  • l3color
  • l3draw
  • l3str
  • l3sys-shell
  • xcoffins
  • xgalley
  • xmarks

l3color


This mod­ule pro­vides sup­port for set­ting col­ors us­ing a range of color mod­els. It also al­lows the con­struc­tion of 'color ex­pres­sions', in which mul­ti­ple col­ors are mixed to­gether at the macro level. There is also sup­port for spot col­ors: the lat­ter is highly ex­per­i­men­tal.

l3draw


This mod­ule pro­vides a code-level in­ter­face for con­struct­ing draw­ings. The in­ter­faces are heav­ily in­spired by the pgf layer of the widely-used TikZ sys­tem.

l3str


A 'string' in terms is a to­ken list in which all of the to­kens have cat­e­gory code 12 ('other'), with the ex­cep­tion of spaces which have the cat­e­gory code 10 ('space'). The l3str bun­dle con­sists of two parts. The first is l3str it­self. This is a col­lec­tion of func­tions to act on strings, in­clud­ing for ma­nip­u­la­tions such as UTF8 map­pings in pdf.

l3sys-shell


This mod­ule pro­vides ab­strac­tions for com­mon shell func­tions, e.g. file dele­tion and copy­ing.

xcoffins


A cof­fin is a 'box with han­dles': a data struc­ture which com­prises both a box and as­so­ci­ated in­for­ma­tion to al­low con­trolled type­set­ting. The xcoffins pack­age pro­vides a high-level in­ter­face for ma­nip­u­lat­ing coffins. This is sup­ported by the lower-level l3coffins pack­age, which pro­vides the data struc­ture.

xgalley


In 3 ter­mi­nol­ogy a gal­ley is a rect­an­gu­lar area which re­ceives text and other ma­te­rial fill­ing it from top. The ver­ti­cally ex­tend of a gal­ley is nor­mally not re­stricted: in­stead cer­tain chunks are taken off the top of an al­ready par­tially filled gal­ley to form columns or sim­i­lar ar­eas on a page. This pro­cess is typ­i­cally asyn­chronous but there are ways to con­trol or change its be­haviour. The xgal­ley mod­ule pro­vides a mech­a­nism for fill­ing gal­leys and con­trol­ling the spac­ing, hy­phen­ation and jus­ti­fi­ca­tion within them.

Dis­cus­sion

Dis­cus­sion con­cern­ing the ap­proach, sug­ges­tions for im­prove­ments, changes, ad­di­tions, etc. should be ad­dressed to the list -L.

You can sub­scribe to this list by send­ing mail to

listserv@urz.uni-heidelberg.de

with the body con­tain­ing

subscribe LATEX-L  <Your-First-Name> <Your-Second-Name>

Is­sues

The is­sue tracker for 3 is cur­rently lo­cated on GitHub.

Please re­port spe­cific is­sues with 3 code there; more gen­eral dis­cus­sion should be di­rected to the -L list.

The 3 Project

Devel­op­ment of 3 is car­ried out by The 3 Project. Cur­rently, the team mem­bers are

  • Jo­hannes Braams
  • David Carlisle
  • Robin Fair­bairns
  • Morten Høgholm
  • Bruno Le Floch
  • Thomas Lotze
  • Frank Mit­tel­bach
  • Will Robert­son
  • Chris Row­ley
  • Rainer Schöpf
  • Joseph Wright

Former mem­bers of The 3 Project team were

  • Michael Downes
  • Denys Duchier
  • Alan Jef­frey
  • Martin Schröder

The de­vel­op­ment team can be con­tacted by e-mail: <la­tex-team@la­tex-project.org>; for gen­eral 3 dis­cus­sion the -L list should be used.


Copy­right (C) 1998-2011,2015-2018 The LaTeX3 Project
http://la­tex-project.org/
All rights re­served.

Down­load the con­tents of this pack­age in one zip archive (3.5M).

l3­ex­per­i­men­tal – Ex­per­i­men­tal 3 con­cepts

The l3­ex­per­i­men­tal pack­ages are a col­lec­tion of ex­per­i­men­tal im­ple­men­ta­tions for as­pects of the 3 ker­nel, deal­ing with higher-level ideas such as the De­signer In­ter­face. Some of them work as stand alone pack­ages, pro­vid­ing new func­tion­al­ity, and can be used on top of with no changes to the ex­ist­ing ker­nel.

The present re­lease in­cludes:

  • l3­color, which pro­vides sup­port for set­ting col­ors us­ing a range of color mod­els;
  • l3­draw, a code-level in­ter­face for con­struct­ing draw­ings;
  • l3str, sup­port for string ma­nip­u­la­tion;
  • l3sys-shell, which pro­vides ab­strac­tions for com­mon shell func­tions like file dele­tion and copy­ing;
  • xcoffins, which al­lows the align­ment of boxes us­ing a se­ries of ‘han­dle’ po­si­tions, sup­ple­ment­ing the sim­ple ref­er­ence point;
  • xgal­ley, which con­trols boxes re­ceiv­ing text for type­set­ting.

Pack­agel3­ex­per­i­men­tal
Home pagehttp://www.la­tex-project.org/code.html
Ver­sion 2018-10-17
Li­censesThe Project Public Li­cense 1.3c
Copy­right1998–2011, 2015–2018 The 3 Project
Main­tainerThe Team
TDS archivel3experimental.tds.zip
Con­tained inTeX Live as l3­ex­per­i­men­tal
MiKTeX as l3­ex­per­i­men­tal
TopicsLay­out
Pre re­lease
3
Macro sup­port
See alsol3kernel
l3packages
...
Guest Book Sitemap Contact Contact Author