Directory macros/latex/contrib/filecontents
+--------------------------------------------+
| FILECONTENTS |
| |
| Improved version of LaTeX2e's filecontents |
| and filecontents* environments |
| |
| By Scott Pakin, scott+fc@pakin.org |
+--------------------------------------------+
Description
-----------
LaTeX2e's filecontents and filecontents* environments enable a LaTeX
source file to generate external files as it's run through latex.
However, there are two limitations of these environments: They refuse
to overwrite existing files; and, they can be used only before the
\documentclass declaration. The filecontents package removes these
limitations, making it possible to overwrite existing files and to use
filecontents/filecontents* anywhere.
Installation
------------
There's nothing special about building filecontents:
latex filecontents.ins <== Generate filecontents.sty
latex filecontents.dtx <== Produce the documentation (filecontents.dvi)
If you're new to this, see https://texfaq.org/#installing for more
information on installing packages.
Copyright and license
---------------------
Copyright (C) 2011-2023 Scott Pakin, scott+fc@pakin.org
This package may be distributed and/or modified under the conditions
of the LaTeX Project Public License, either version 1.3c 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.3c or later is part of all distributions of LaTeX
version 2008/05/04 or later.
Download the contents of this package in one zip archive (282.9k).
filecontents – Create an external file from within a LaTeX document
LaTeX2ε’s filecontents and filecontents* environments enable a LaTeX source file to generate external files as it runs through LaTeX. However, there are two limitations of these environments: they refuse to overwrite existing files, and they can only be used in the preamble of a document. The filecontents package removes these limitations, letting you overwrite existing files and letting you use filecontents/filecontents* anywhere.
As of September 2019 the author tells us: “This package is no longer necessary due to its functionality having moved into recent LaTeX kernels. It’s probably better not to move the package to obsolete because users may need it to rebuild old documents. Version 1.5 provides full functionality when run with an older kernel but issues a warning message and disables itself when run with a newer kernel.”
Supply the overwrite option to LaTeX’s built-in filecontents environment to mimic this package’s behavior:
\begin{filecontents}[overwrite]{my-file}...\end{filecontents}
| Package | filecontents |
| Version | 1.5a 2023-04-02 |
| Licenses | The LaTeX Project Public License 1.3c |
| Copyright | 2011–2023 Scott Pakin |
| Maintainer | Scott Pakin |
| Contained in | TeX Live as filecontents MiKTeX as filecontents |
| Topics | File management |
