c2616f298c
Instead of "section" or "part" without a folowing number, a reference to an unnumbered section renders as the section name in quotes and then "on page <n>" (to help clarify that the quoted part is a section name). More generally, enable LaTeX macros for `secref' to work with the LaTeX-level label (to expand to a page number, for example) in the case of document-local references. Closes PR 13935 original commit: 68d9da17fa9e9b1957ca6426727773cc4f1bb8ca
264 lines
11 KiB
TeX
264 lines
11 KiB
TeX
% This is the default style configuration for Scribble-generated Latex
|
|
|
|
\usepackage{graphicx}
|
|
\usepackage{hyperref}
|
|
\renewcommand{\rmdefault}{ptm}
|
|
\usepackage{stabular}
|
|
\usepackage{relsize}
|
|
\usepackage{wasysym}
|
|
\usepackage{textcomp}
|
|
\usepackage{framed}
|
|
\usepackage[htt]{hyphenat}
|
|
\usepackage[usenames,dvipsnames]{color}
|
|
\hypersetup{bookmarks=true,bookmarksopen=true,bookmarksnumbered=true}
|
|
\IfFileExists{tocstyle.sty}{\usepackage{tocstyle}\usetocstyle{standard}}{}
|
|
\IfFileExists{CJK.sty}{\usepackage{CJK}}{}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
% Configuration that is especially meant to be overridden:
|
|
|
|
% Inserted before every ``chapter'', useful for starting each one on a new page:
|
|
\newcommand{\sectionNewpage}{}
|
|
% Inserted before every book ``part''
|
|
\newcommand{\partNewpage}{\sectionNewpage}
|
|
|
|
% Hooks for actions within the `document' environment:
|
|
\newcommand{\preDoc}{}
|
|
\newcommand{\postDoc}{}
|
|
|
|
% Generated by `secref'; first arg is section number, second is section title:
|
|
\newcommand{\BookRef}[2]{\emph{#2}}
|
|
\newcommand{\ChapRef}[2]{\SecRef{#1}{#2}}
|
|
\newcommand{\SecRef}[2]{section~#1}
|
|
\newcommand{\PartRef}[2]{part~#1}
|
|
% Generated by `Secref':
|
|
\newcommand{\BookRefUC}[2]{\BookRef{#1}{#2}}
|
|
\newcommand{\ChapRefUC}[2]{\SecRefUC{#1}{#2}}
|
|
\newcommand{\SecRefUC}[2]{Section~#1}
|
|
\newcommand{\PartRefUC}[2]{Part~#1}
|
|
|
|
% Variants of the above with a label for an internal reference:
|
|
\newcommand{\BookRefLocal}[3]{\BookRef{#2}{#3}}
|
|
\newcommand{\ChapRefLocal}[3]{\ChapRef{#2}{#3}}
|
|
\newcommand{\SecRefLocal}[3]{\SecRef{#2}{#3}}
|
|
\newcommand{\PartRefLocal}[3]{\PartRef{#2}{#3}}
|
|
\newcommand{\BookRefLocalUC}[3]{\BookRefUC{#2}{#3}}
|
|
\newcommand{\ChapRefLocalUC}[3]{\ChapRefUC{#2}{#3}}
|
|
\newcommand{\SecRefLocalUC}[3]{\SecRefUC{#2}{#3}}
|
|
\newcommand{\PartRefLocalUC}[3]{\PartRefUC{#2}{#3}}
|
|
|
|
% Variants of the above with a section number is empty (i.e., UnNumbered):
|
|
\newcommand{\BookRefUN}[1]{\BookRef{}{#1}}
|
|
\newcommand{\ChapRefUN}[1]{\SecRefUN{#1}}
|
|
\newcommand{\SecRefUN}[1]{``#1''}
|
|
\newcommand{\PartRefUN}[1]{\SecRefUN{#1}}
|
|
\newcommand{\BookRefUCUN}[1]{\BookRefUN{#1}}
|
|
\newcommand{\ChapRefUCUN}[1]{\ChapRefUN{#1}}
|
|
\newcommand{\SecRefUCUN}[1]{\SecRefUN{#1}}
|
|
\newcommand{\PartRefUCUN}[1]{\PartRefUN{#1}}
|
|
|
|
\newcommand{\BookRefLocalUN}[2]{\BookRefUN{#2}}
|
|
\newcommand{\ChapRefLocalUN}[2]{\SecRefLocalUN{#1}{#2}}
|
|
\newcommand{\SecRefLocalUN}[2]{\SecRefUN{#2} on page~\pageref{#1}}
|
|
\newcommand{\PartRefLocalUN}[2]{\SecRefLocalUN{#1}{#2}}
|
|
\newcommand{\BookRefLocalUCUN}[2]{\BookRefLocalUN{#1}{#2}}
|
|
\newcommand{\ChapRefLocalUCUN}[2]{\ChapRefLocalUN{#1}{#2}}
|
|
\newcommand{\SecRefLocalUCUN}[2]{\SecRefLocalUN{#1}{#2}}
|
|
\newcommand{\PartRefLocalUCUN}[2]{\PartRefLocalUN{#1}{#2}}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
% Fonts
|
|
|
|
% Font commands used by generated text:
|
|
\newcommand{\Scribtexttt}[1]{{\texttt{#1}}}
|
|
\newcommand{\textsub}[1]{$_{\hbox{\textsmaller{#1}}}$}
|
|
\newcommand{\textsuper}[1]{$^{\hbox{\textsmaller{#1}}}$}
|
|
\newcommand{\intextcolor}[2]{\textcolor{#1}{#2}}
|
|
\newcommand{\intextrgbcolor}[2]{\textcolor[rgb]{#1}{#2}}
|
|
\newcommand{\incolorbox}[2]{{\fboxrule=0pt\fboxsep=0pt\colorbox{#1}{#2}}}
|
|
\newcommand{\inrgbcolorbox}[2]{{\fboxrule=0pt\fboxsep=0pt\colorbox[rgb]{#1}{#2}}}
|
|
\newcommand{\plainlink}[1]{#1}
|
|
\newcommand{\techoutside}[1]{#1}
|
|
\newcommand{\techinside}[1]{#1}
|
|
\newcommand{\badlink}[1]{#1}
|
|
\newcommand{\indexlink}[1]{#1}
|
|
\newcommand{\noborder}[1]{#1}
|
|
\newcommand{\imageleft}[1]{} % drop it
|
|
\newcommand{\Smaller}[1]{\textsmaller{#1}}
|
|
\newcommand{\Larger}[1]{\textlarger{#1}}
|
|
\newcommand{\planetName}[1]{PLane\hspace{-0.1ex}T}
|
|
\newcommand{\slant}[1]{{\textsl{#1}}}
|
|
|
|
% Used for <, >, and | in tt mode. For some fonts and installations,
|
|
% there seems to be an encoding issue, so pick T1 explicitly:
|
|
\newcommand{\Stttextmore}{{\fontencoding{T1}\selectfont>}}
|
|
\newcommand{\Stttextless}{{\fontencoding{T1}\selectfont<}}
|
|
\newcommand{\Stttextbar}{{\fontencoding{T1}\selectfont|}}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
% Tables
|
|
|
|
% The `stabular' environment seems to be the lesser of evils among
|
|
% page-breaking table environments:
|
|
\newenvironment{bigtabular}{\begin{stabular}}{\end{stabular}}
|
|
% For the 'boxed table style:
|
|
\newcommand{\SBoxedLeft}{\textcolor[rgb]{0.6,0.6,1.0}{\vrule width 3pt\hspace{3pt}}}
|
|
% Formerly used to keep the horizontal line for a definition on the same page:
|
|
\newcommand{\SEndFirstHead}[0]{ \nopagebreak \\ }
|
|
% Corrects weirdness when a table is the first thing in
|
|
% an itemization:
|
|
\newcommand{\bigtableinlinecorrect}[0]{~
|
|
|
|
\vspace{-\baselineskip}\vspace{\parskip}}
|
|
% Used to indent the table correctly in an itemization, since that's
|
|
% one of the things stabular gets wrong:
|
|
\newlength{\stabLeft}
|
|
\newcommand{\bigtableleftpad}{\hspace{\stabLeft}}
|
|
\newcommand{\atItemizeStart}[0]{\addtolength{\stabLeft}{\labelsep}
|
|
\addtolength{\stabLeft}{\labelwidth}}
|
|
|
|
|
|
% For a single-column table in simple environments, it's better to
|
|
% use the `list' environment instead of `stabular'.
|
|
\newenvironment{SingleColumn}{\begin{list}{}{\topsep=0pt\partopsep=0pt%
|
|
\listparindent=0pt\itemindent=0pt\labelwidth=0pt\leftmargin=0pt\rightmargin=0pt%
|
|
\itemsep=0pt\parsep=0pt}\item}{\end{list}}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
% Etc.
|
|
|
|
% ._ and .__
|
|
\newcommand{\Sendabbrev}[1]{#1\@}
|
|
\newcommand{\Sendsentence}[1]{\@#1}
|
|
|
|
% Default style for a nested flow:
|
|
\newenvironment{Subflow}{\begin{list}{}{\topsep=0pt\partopsep=0pt%
|
|
\listparindent=0pt\itemindent=0pt\labelwidth=0pt\leftmargin=0pt\rightmargin=0pt%
|
|
\itemsep=0pt}\item}{\end{list}}
|
|
|
|
% The 'inset nested-flow style uses the `quote' environment
|
|
|
|
% Indent a 'code-inset nested flow:
|
|
\newcommand{\SCodePreSkip}{\vskip\abovedisplayskip}
|
|
\newcommand{\SCodePostSkip}{\vskip\belowdisplayskip}
|
|
\newenvironment{SCodeFlow}{\SCodePreSkip\begin{list}{}{\topsep=0pt\partopsep=0pt%
|
|
\listparindent=0pt\itemindent=0pt\labelwidth=0pt\leftmargin=2ex\rightmargin=2ex%
|
|
\itemsep=0pt\parsep=0pt}\item}{\end{list}\SCodePostSkip}
|
|
\newcommand{\SCodeInsetBox}[1]{\setbox1=\hbox{\hbox{\hspace{2ex}#1\hspace{2ex}}}\vbox{\SCodePreSkip\vtop{\box1\SCodePostSkip}}}
|
|
|
|
% Inset a 'vertical-inset nested flow:
|
|
\newcommand{\SVInsetPreSkip}{\vskip\abovedisplayskip}
|
|
\newcommand{\SVInsetPostSkip}{\vskip\belowdisplayskip}
|
|
\newenvironment{SVInsetFlow}{\SVInsetPreSkip\begin{list}{}{\topsep=0pt\partopsep=0pt%
|
|
\listparindent=0pt\itemindent=0pt\labelwidth=0pt\leftmargin=0pt\rightmargin=0pt%
|
|
\itemsep=0pt\parsep=0pt}\item}{\end{list}\SVInsetPostSkip}
|
|
\newcommand{\SVInsetBox}[1]{\setbox1=\hbox{\hbox{#1}}\vbox{\SCodePreSkip\vtop{\box1\SCodePostSkip}}}
|
|
|
|
% The 'compact itemization style:
|
|
\newenvironment{compact}{\begin{itemize}}{\end{itemize}}
|
|
\newcommand{\compactItem}[1]{\item #1}
|
|
|
|
% The nested-flow style for `centerline':
|
|
\newenvironment{SCentered}{\begin{trivlist}\item \centering}{\end{trivlist}}
|
|
|
|
% The \refpara command corresponds to `margin-note'. The
|
|
% refcolumn and refcontent environments also wrap the note,
|
|
% because they simplify the CSS side.
|
|
\newcommand{\refpara}[1]{\normalmarginpar\marginpar{\raggedright \footnotesize #1}}
|
|
\newcommand{\refelem}[1]{\refpara{#1}}
|
|
\newenvironment{refcolumn}{}{}
|
|
\newenvironment{refcontent}{}{}
|
|
|
|
\newcommand{\refparaleft}[1]{\reversemarginpar\marginpar{\raggedright \footnotesize #1}}
|
|
\newcommand{\refelemleft}[1]{\refparaleft{#1}}
|
|
\newenvironment{refcolumnleft}{\begin{refcolumn}}{\end{refcolumn}}
|
|
|
|
% Macros used by `title' and `author':
|
|
\newcommand{\titleAndVersionAndAuthors}[3]{\title{#1\\{\normalsize \SVersionBefore{}#2}}\author{#3}\maketitle}
|
|
\newcommand{\titleAndVersionAndEmptyAuthors}[3]{\title{#1\\{\normalsize \SVersionBefore{}#2}}#3\maketitle}
|
|
\newcommand{\titleAndEmptyVersionAndAuthors}[3]{\title{#1}\author{#3}\maketitle}
|
|
\newcommand{\titleAndEmptyVersionAndEmptyAuthors}[3]{\title{#1}\maketitle}
|
|
\newcommand{\SAuthor}[1]{#1}
|
|
\newcommand{\SAuthorSep}[1]{\qquad}
|
|
\newcommand{\SVersionBefore}[1]{Version }
|
|
|
|
% Useful for some styles, such as sigalternate:
|
|
\newcommand{\SNumberOfAuthors}[1]{}
|
|
|
|
% sections
|
|
\newcommand{\Spart}[2]{\part[#1]{#2}}
|
|
\newcommand{\Ssection}[2]{\section[#1]{#2}}
|
|
\newcommand{\Ssubsection}[2]{\subsection[#1]{#2}}
|
|
\newcommand{\Ssubsubsection}[2]{\subsubsection[#1]{#2}}
|
|
\newcommand{\Ssubsubsubsection}[2]{{\bf #2}}
|
|
\newcommand{\Ssubsubsubsubsection}[2]{\Ssubsubsubsection{#1}{#2}}
|
|
|
|
% "star" means unnumbered and not in ToC:
|
|
\newcommand{\Spartstar}[1]{\part*{#1}}
|
|
\newcommand{\Ssectionstar}[1]{\section*{#1}}
|
|
\newcommand{\Ssubsectionstar}[1]{\subsection*{#1}}
|
|
\newcommand{\Ssubsubsectionstar}[1]{\subsubsection*{#1}}
|
|
\newcommand{\Ssubsubsubsectionstar}[1]{{\bf #1}}
|
|
\newcommand{\Ssubsubsubsubsectionstar}[1]{\Ssubsubsubsectionstar{#1}}
|
|
|
|
% "starx" means unnumbered but in ToC:
|
|
\newcommand{\Spartstarx}[2]{\Spartstar{#2}\addcontentsline{toc}{part}{#1}}
|
|
\newcommand{\Ssectionstarx}[2]{\Ssectionstar{#2}\addcontentsline{toc}{section}{#1}}
|
|
\newcommand{\Ssubsectionstarx}[2]{\Ssubsectionstar{#2}\addcontentsline{toc}{subsection}{#1}}
|
|
\newcommand{\Ssubsubsectionstarx}[2]{\Ssubsubsectionstar{#2}\addcontentsline{toc}{subsubsection}{#1}}
|
|
\newcommand{\Ssubsubsubsectionstarx}[2]{\Ssubsubsubsectionstar{#2}}
|
|
\newcommand{\Ssubsubsubsubsectionstarx}[2]{\Ssubsubsubsubsectionstar{#2}}
|
|
|
|
% "grouper" is for the 'grouper style variant --- on subsections and lower,
|
|
% because \Spart is used for grouper at the section level. Grouper implies
|
|
% unnumbered.
|
|
\newcounter{GrouperTemp}
|
|
\newcommand{\Ssubsectiongrouper}[2]{\setcounter{GrouperTemp}{\value{subsection}}\Ssubsectionstarx{#1}{#2}\setcounter{subsection}{\value{GrouperTemp}}}
|
|
\newcommand{\Ssubsubsectiongrouper}[2]{\setcounter{GrouperTemp}{\value{subsubsection}}\Ssubsubsectionstarx{#1}{#2}\setcounter{subsubsection}{\value{GrouperTemp}}}
|
|
\newcommand{\Ssubsubsubsectiongrouper}[2]{\Ssubsubsubsectionstarx{#1}{#2}}
|
|
\newcommand{\Ssubsubsubsubsectiongrouper}[2]{\Ssubsubsubsubsectionstarx{#1}{#2}}
|
|
|
|
\newcommand{\Ssubsectiongrouperstar}[1]{\setcounter{GrouperTemp}{\value{subsection}}\Ssubsectionstar{#1}\setcounter{subsection}{\value{GrouperTemp}}}
|
|
\newcommand{\Ssubsubsectiongrouperstar}[1]{\setcounter{GrouperTemp}{\value{subsubsection}}\Ssubsubsectionstar{#1}\setcounter{subsubsection}{\value{GrouperTemp}}}
|
|
\newcommand{\Ssubsubsubsectiongrouperstar}[1]{\Ssubsubsubsectionstar{#1}}
|
|
\newcommand{\Ssubsubsubsubsectiongrouperstar}[1]{\Ssubsubsubsubsectionstar{#1}}
|
|
|
|
% Generated by `subsubsub*section':
|
|
\newcommand{\SSubSubSubSection}[1]{\Ssubsubsubsubsectionstar{#1}}
|
|
|
|
% For hidden parts with an empty title:
|
|
\newcommand{\notitlesection}{\vspace{2ex}\phantomsection\noindent}
|
|
|
|
% To increments section numbers:
|
|
\newcommand{\Sincpart}{\stepcounter{part}}
|
|
\newcommand{\Sincsection}{\stepcounter{section}}
|
|
\newcommand{\Sincsubsection}{\stepcounter{subsection}}
|
|
\newcommand{\Sincsubsubsection}{\stepcounter{subsubsection}}
|
|
\newcommand{\Sincsubsubsubsection}{}
|
|
\newcommand{\Sincsubsubsubsubsection}{}
|
|
|
|
% When brackets appear in section titles:
|
|
\newcommand{\SOpenSq}{[}
|
|
\newcommand{\SCloseSq}{]}
|
|
|
|
% Helper for box-mode macros:
|
|
\newcommand{\Svcenter}[1]{$\vcenter{#1}$}
|
|
|
|
% Helper to work around a problem with "#"s for URLs within \href
|
|
% within other macros:
|
|
\newcommand{\Shref}[3]{\href{#1\##2}{#3}}
|
|
|
|
% For URLs:
|
|
\newcommand{\Snolinkurl}[1]{\nolinkurl{#1}}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
% Scribble then generates the following:
|
|
%
|
|
% \begin{document}
|
|
% \preDoc
|
|
% \titleAndVersion{...}{...}
|
|
% ... document content ...
|
|
% \postDoc
|
|
% \end{document}
|