Menu
▾
▴
[Docutils-checkins] SF.net SVN: docutils:[8550] trunk/docutils
|
From: <mi...@us...> - 2020-09-01 21:49:50
|
Revision: 8550
http://sourceforge.net/p/docutils/code/8550
Author: milde
Date: 2020-09-01 21:49:48 +0000 (Tue, 01 Sep 2020)
Log Message:
-----------
Formatting (no change to functionality).
Modified Paths:
--------------
trunk/docutils/docutils/writers/latex2e/docutils.sty
trunk/docutils/test/functional/expected/latex_memoir.tex
trunk/docutils/test/functional/expected/standalone_rst_latex.tex
Modified: trunk/docutils/docutils/writers/latex2e/docutils.sty
===================================================================
--- trunk/docutils/docutils/writers/latex2e/docutils.sty 2020-08-30 13:07:56 UTC (rev 8549)
+++ trunk/docutils/docutils/writers/latex2e/docutils.sty 2020-09-01 21:49:48 UTC (rev 8550)
@@ -14,35 +14,46 @@
% .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause
%
%
-% :Abstract: Helper commands and element definitions for Docutils_ LaTeX output.
+% :Abstract:
+% Helper commands and element definitions for Docutils_ LaTeX output.
%
-% :Identification:
-% ::
-
-\NeedsTeXFormat{LaTeX2e}
-\ProvidesPackage{docutils}
- [2020/08/28 v0.1 macros for Docutils LaTeX output]
-
-% Changelog:
-% .. class:: borderless
+% :Changelog:
+% .. class:: borderless
%
-% ====== ========== =========================================================
-% 0.1 2020-08-28 initial version
-% ====== ========== =========================================================
+% ====== ========== =========================================================
+% 0.1 2020-08-28 initial version
+% ====== ========== =========================================================
%
+% Installation
+% ============
%
-% Motivation
-% ==========
+% Copy/Move/Link ``docutils.sty`` to a suitable place in the “TeX Directory
+% Structure” (TDS_) and run ``texhash``, or place it in the current working
+% directory (e.g. for testing).
%
-% Several elements of the `Docutils document tree`_ have no corresponding
-% LaTeX construct. Others lack configurability_.
+% Usage
+% =====
%
-% Authors may specify this package with the `"stylesheet"`_ configuration_
-% option. Alternatively, the `Docutils LaTeX writer`_ will extract required
-% definitions and insert them into the preamble of generated documents.
+% When generating LaTeX documents from reStructuredText sources,
+% specify this package with the `"stylesheet"`_ configuration_ option, e.g.
+% ``rst2latex --stylesheet=docutils``.
+% Alternatively, the Docutils `LaTeX writer` will extract required definitions
+% and insert them into the preamble of generated documents
+% (see `Docutils LaTeX Writer`_ for details).
+%
+%
+% Implementation
+% ==============
+%
+% ::
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{docutils}
+ [2020/08/28 v0.1 macros for Docutils LaTeX output]
+
+
% Helpers
-% =======
+% -------
%
% duclass::
@@ -51,7 +62,8 @@
% \end{DUclass}{spam} tries \endDUCLASSspam
\ifx\DUclass\undefined % poor man's "provideenvironment"
\newenvironment{DUclass}[1]%
- {\def\DocutilsClassFunctionName{DUCLASS#1}% "#1" does not work in end-part of environment.
+ {% "#1" does not work in end-part of environment.
+ \def\DocutilsClassFunctionName{DUCLASS#1}
\csname \DocutilsClassFunctionName \endcsname}%
{\csname end\DocutilsClassFunctionName \endcsname}%
\fi
@@ -65,7 +77,7 @@
% Configuration defaults
-% ======================
+% ----------------------
%
% See `Docutils LaTeX Writer`_ for details.
%
@@ -83,7 +95,7 @@
}
% TODO: add \em to set dedication text in italics?
-
+%
% docinfo::
% width of docinfo table
@@ -102,7 +114,7 @@
\providecommand*\DUrolestring[1]{\textit{#1}}
% Elements
-% ============
+% --------
%
% Definitions for unknown or to-be-configured Docutils elements
% and roles (inline elements).
@@ -244,11 +256,11 @@
}
% References
-% ----------
+% ==========
%
% .. [Docutils] https://docutils.sourceforge.io/
%
-% .. _Docutils Document Tree:
+% .. _Docutils Document Tree:
% https://docutils.sourceforge.io/docs/ref/doctree.html
%
% .. _Docutils LaTeX Writer:
@@ -260,5 +272,4 @@
% .. _"stylesheet":
% https://docutils.sourceforge.io/docs/user/config.html#stylesheet-latex-writers
%
-% .. _configurability:
-% https://docutils.sourceforge.io/docs/user/latex.html#how-to-configure-the
+% .. _TDS: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds
Modified: trunk/docutils/test/functional/expected/latex_memoir.tex
===================================================================
--- trunk/docutils/test/functional/expected/latex_memoir.tex 2020-08-30 13:07:56 UTC (rev 8549)
+++ trunk/docutils/test/functional/expected/latex_memoir.tex 2020-09-01 21:49:48 UTC (rev 8550)
@@ -41,7 +41,8 @@
% \end{DUclass}{spam} tries \endDUCLASSspam
\ifx\DUclass\undefined % poor man's "provideenvironment"
\newenvironment{DUclass}[1]%
- {\def\DocutilsClassFunctionName{DUCLASS#1}% "#1" does not work in end-part of environment.
+ {% "#1" does not work in end-part of environment.
+ \def\DocutilsClassFunctionName{DUCLASS#1}
\csname \DocutilsClassFunctionName \endcsname}%
{\csname end\DocutilsClassFunctionName \endcsname}%
\fi
Modified: trunk/docutils/test/functional/expected/standalone_rst_latex.tex
===================================================================
--- trunk/docutils/test/functional/expected/standalone_rst_latex.tex 2020-08-30 13:07:56 UTC (rev 8549)
+++ trunk/docutils/test/functional/expected/standalone_rst_latex.tex 2020-09-01 21:49:48 UTC (rev 8550)
@@ -41,7 +41,8 @@
% \end{DUclass}{spam} tries \endDUCLASSspam
\ifx\DUclass\undefined % poor man's "provideenvironment"
\newenvironment{DUclass}[1]%
- {\def\DocutilsClassFunctionName{DUCLASS#1}% "#1" does not work in end-part of environment.
+ {% "#1" does not work in end-part of environment.
+ \def\DocutilsClassFunctionName{DUCLASS#1}
\csname \DocutilsClassFunctionName \endcsname}%
{\csname end\DocutilsClassFunctionName \endcsname}%
\fi
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
