Settings Help
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/info/dtxgallery

============
 DTXGALLERY 
============

This work is a collection of files that demonstrate 
simple things that are possible with the flexible 
and under-appreciated docstrip file format.

It is intended as a companion to Scott Pakin's
excellent and influential "dtxtut" example of producing
LaTeX packages in this way.

This work consists of the following files:

--------------
dtxgallery.dtx

A `meta-example' showing how multiple .dtx files can be
documented in a single file. Read the .pdf version of this
file first. 
--------------

-----------------
single-source.dtx

This is an example of both the .sty and .ins
files being extracted from the .dtx file. This
allows maintenance of a single source file
but still produces a "standard-behaviour" .dtx/.ins
pair for upload to CTAN.
-----------------

--------------------
conditional-code.dtx

This example shows how code can be extracted in different
contexts. For example, debug code in a package can be
included in the source .dtx file but be automatically
stripped out for the public release version of the package.
--------------------

-------------
rearrange.dtx

This example demonstrates how source code may
be written and documented in a different logical 
order than in which it is required to execute.

This can be useful, for example, when default 
values are provided at the very stage of the package 
loading, but you wish to describe them first in the 
main body of the (non-technical) documentation.
-------------


Maintained by Will Robertson, 2007.
Please send comments and suggestions (entire examples very
welcome!) to me at the typeset string of:
  \zap@space wspr \number`\Q \char64 gmail \char46 com {}

Distributed under the LaTeX Project Public License, version
1.3c or higher (your choice).

Files

Name Size Date Notes
README 1776 2007-08-05 08:02:00
conditional-code.dtx 1426 2007-08-06 03:09:00
conditional-code.pdf 47941 2007-08-06 03:09:00
dtxgallery.dtx 6401 2007-08-06 03:11:00
dtxgallery.pdf 150729 2007-08-06 03:12:00
rearrange.dtx 1078 2007-08-06 03:06:00
rearrange.pdf 96421 2007-06-12 12:43:00
single-source.dtx 1471 2007-08-05 08:08:00
single-source.pdf 83159 2007-06-12 12:31:00

Down­load the com­plete con­tents of this di­rec­tory in one zip archive (350.8k).

DTX gallery – A small col­lec­tion of min­i­mal DTX ex­am­ples

A col­lec­tion of files that demon­strate sim­ple things that are pos­si­ble with the flex­i­ble and un­der-ap­pre­ci­ated doc­strip file for­mat. Each file of the col­lec­tion is pro­vided as a .dtx file and as the cor­re­spond­ing .pdf.

The set is in­tended as a com­pan­ion to Scott Pakin’s ex­cel­lent and in­flu­en­tial dtx­tut ex­am­ple of pro­duc­ing LaTeX pack­ages in this way.

Doc­u­men­ta­tion
Ver­sion1
Li­censeThe LaTeX Project Public Li­cense
Main­tainerWill Robert­son
Con­tained inTeXLive as dtx­gallery
Topics code that serves as ex­am­ples of tex pro­gram­ming
Guest Book Sitemap Contact 2014-04-16 20:58 CEST