summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/tex/latex/morehype/lnavicol.sty
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/tex/latex/morehype/lnavicol.sty')
-rw-r--r--Master/texmf-dist/tex/latex/morehype/lnavicol.sty141
1 files changed, 114 insertions, 27 deletions
diff --git a/Master/texmf-dist/tex/latex/morehype/lnavicol.sty b/Master/texmf-dist/tex/latex/morehype/lnavicol.sty
index 030a7822e07..6648814f3bc 100644
--- a/Master/texmf-dist/tex/latex/morehype/lnavicol.sty
+++ b/Master/texmf-dist/tex/latex/morehype/lnavicol.sty
@@ -1,4 +1,4 @@
-\ProvidesPackage{lnavicol}[2011/09/02
+\ProvidesPackage{lnavicol}[2011/10/10
left navigation column with blog.sty]
%%
%% Copyright (C) 2011 Uwe Lueck,
@@ -16,65 +16,122 @@
%%
%% http://www.contact-ednotes.sty.de.vu
%%
+%% == 'blog.sty' Required ==
+%% ---but what about options (TODO)? %% 2011/10/09
\RequirePackage{blog}
-
-\newif\iftight \newif\ifdeep %% 2011/04/29
-%% PAGE STYLE SETTINGs (to be set locally):
+%%
+%% == Switches ==
+%% %% introduced 2011/04/29, it seems
+%% There is a ``standard" page width and a ``tight one"
+%% (the latter for contact forms)---|\iftight|:
+\newif\iftight
+%% In order to move an anchor to the \emph{top} of the screen
+%% when the anchor is near the page end, the page must get
+%% some extra length by adding empty space at its
+%% bottom---|\ifdeep|:
+\newif\ifdeep
+%%
+%% == Page Style Settings (to be set locally) ==
% \newcommand*{\pagebgcolor}{\#f5f5f5} %% CSS whitesmoke
% \newcommand*{\pagespacing}{\@cellpadding{4} \@cellspacing{7}}
% \newcommand*{\pagenavicolwidth}{125}
% \newcommand*{\pagemaincolwidth}{584}
% \newcommand*{\pagewholewidth} {792}
-
-%% possible ADDITIONS to blog.sty:
+%% == Possible Additions to 'blog.sty' ==
+%% === Tables ===
+%% |\begin{spancolscell}{<number>}{<style>}|
+%% opens an environment that contains a row and a single cell
+%% that will span <number> table cells and have style <style>:
\newenvironment{spancolscell}[2]{%
\starttr\startTd{\@colspan{#1} #2 %
\@width{100\%}}% %% TODO works?
}{\endTd\endtr}
+%% The |{hiddencells}| einvironment contains cells that do not align
+%% with other cells in the surrounding table. The purpose is using
+%% cells for horizontal spacing.
\newenvironment{hiddencells}
{\startTable{}\starttr}
{\endtr\endTable}
+%% |{pagehiddencells}| is like `{hiddencells}' except that
+%% the \HTML\ code is indented:
\newenvironment{pagehiddencells}
{\indentii\hiddencells}
{\indentii\endhiddencells}
+%% |\begin{FixedWidthCell}{<width>}{<style>}| \ opens the
+%% `{FixedWidthCell}' environment. The content will form a cell
+%% of width <width>. <style> are additional formatting parameters:
\newenvironment{FixedWidthCell}[2]
{\startTd{#2}\startTable{\@width{#1}}%
\starttr\startTd{}}
{\endTd\endtr\endTable\endTd}
+%% |\tablehspace{<width>}| is a variant of \LaTeX's `\hspace{<glue>}'.
+%% It may appear in a table row:
\newcommand*{\tablehspace}[1]{\startTd{\@width{#1} /}}
-%% <img>:
+%%
+%% === Graphics ===
+%% The command names in this section are inspired by the names
+%% in the standard \LaTeX\ \ctanpkgref{graphics} package.
+%% (They may need some re-organization TODO.)
+%%
+%% |\simpleinclgrf{<file>}| embeds a graphic file <file> without
+%% the tricks of the remaining commands.
\newcommand*{\simpleinclgrf}[1]{\IncludeGrf{alt="" \@border{0}}%
{#1}}
+%% |\IncludeGrf{<style>}{<file>}| embeds a graphic file <file>
+%% with style settings <style>:
\newcommand*{\IncludeGrf}[2]{<img #1 src="#2">}
+%% |\includegraphic{<width>}{<height>}{<file>}{<border>}{<alt>}{<tooltip>}|
+%% ...\,:
\newcommand*{\includegraphic}[6]{%
\IncludeGrf{%
\@width{#1} \@height{#2} %% data; presentation:
\@border{#4}
alt="#5" \@title{#6}}%
{#3}}
-\newcommand*{\insertgraphic}[9]{% %% TODO cf. ...
+%% |\insertgraphic{<wd>}{<ht>}{<f>}{<b>}{<align>}{<hsp>}{<vsp>}{<alt>}{<t>}|
+%% \\adds <hsp> for the `@hspace' and <vsp> for the `@vspace'
+%% attribute:
+\newcommand*{\insertgraphic}[9]{%
\IncludeGrf{%
\@width{#1} \@height{#2} %% data; presentation:
\@border{#4}
align="#5" hspace="#6" vspace="#8"
alt="#8" \@title{#9}}%
{#3}}
+%% |\includegraphic{<wd>}{<ht>}{<file>}{<anchor>}{<border>}{<alt>}{<tooltip>}|
+%% \\uses an image with `\includegraphic' parameters as a link to
+%% <anchor>:
\newcommand*{\inclgrfref}[7]{%
\fileref{#4}{\includegraphic{#1}{#2}{#3}%
{#5}{#6}{#7}}}
-
-%% HTTP/Wikipedia tooltips:
+%%
+%% === \acro{HTTP}/Wikipedia tooltips ===
+%% |\httptipref{<tip>}{<www>}{<text>}| \ works like \
+%% `\httpref{<www>}{<text>}' except that <tip> appears as ``tooltip":
\newcommand*{\httptipref}[2]{%
\TagSurr a{\@title{#1}\@href{http://#2}\@target@blank}}
-%% TODO \@title bad with pdfLaTeX.
-\newcommand*{\@target@blank}{target="blank"}
+%% |\@target@blank| abbreviates the `@target' setting for
+%% opening the target in a new window or tab:
+\newcommand*{\@target@blank}{target="_blank"}
+%% % |\wikitipref{<language-code>}{<lemma>}{<text>}| \
+%% |\wikitipref{<lc>}{<lem>}{<text>}|
+%% works like
+%% % \\
+%% % `\wikiref{<language-code>}{<lemma>}{<text>}'
+%% `\wikiref{<lc>}{<lem>}{<text>}'
+%% except that
+%% ``Wikipedia" appears as ``tooltip".
+%% |\wikideref| and |\wikienref| are redefined to use it:
\newcommand*{\wikitipref}[2]{%
\httptipref{Wikipedia}{#1.wikipedia.org/wiki/#2}}
\renewcommand*{\wikideref}{\wikitipref{de}}
\renewcommand*{\wikienref}{\wikitipref{en}}
-
-
-%% PAGE STRUCTURE:
+%%
+%% == Page Structure ==
+%% The body of the page is a table of three rows and two columns.
+%% === Page Head Row ===
+%% |\PAGEHEAD| opens the head row and a single cell that will span
+%% the two columns of the second row.
\newcommand*{\PAGEHEAD}{%
\startTable{%
\@align@c\
@@ -84,40 +141,64 @@
\iftight \else \@width\pagewholewidth \fi
}\CLBrk
%% omitting <tbody>
- \ \comment{ HEAD ROW / }\CLBrk
+ \ \comment{ HEAD ROW }\CLBrk
\indenti\spancolscell{2}{}%
}
-%% general head macros:
-\newcommand*{\headgrf} [1]{%
- \indentiii\simplecell{\simpleinclgrf{#1}}}
-\newcommand*{\headskip} {\indentiii\tablehspace}
-\newcommand*{\headtitle}[2]{\indentiii\simplecell{\heading#1{#2}}}
+% \newcommand*{\headgrf} [1]{% %% rm. 2011/10/09
+% \indentiii\simplecell{\simpleinclgrf{#1}}}
% \newcommand*{\headgrfskiptitle}[3]{%
% \pagehiddencells
% \headgrf{#1}\CLBrk
% \headskip{#2}\CLBrk
% \headtitle1{#3}\CLBrk
% \endpagehiddencells}
+%% |\headuseskiptitle{<grf>}{<skip>}{<title>}|
+%% first places <grf>, then skips horizontally by <skip>,
+%% and then prints the page title as \xmltagcode{h1}:
\newcommand*{\headuseskiptitle}[3]{%
\pagehiddencells\CLBrk
\indentiii\simplecell{#1}\CLBrk
\headskip{#2}\CLBrk
\headtitle1{#3}\CLBrk
\endpagehiddencells}
-
+%% |\headskip{<skip>}| is like `\tablehspace{<skip>}'
+%% except that the \HTML\ code gets an indent.
+\newcommand*{\headskip} {\indentiii\tablehspace}
+%% Similarly, |\headtitle{<digit>}{<text>}| is like
+%% `\heading<digit>{<text>}' apart from an indent and
+%% being put into a cell:
+\newcommand*{\headtitle}[2]{\indentiii\simplecell{\heading#1{#2}}}
+%%
+%% === Navigation and Main Row ===
+%% |\PAGENAVI| closes the head row and opens the ``navigation"
+%% column, actually including an `{itemize}' environment.
+%% Accordingly, `writings.fdf' has a command `\fileitem'.
+%% But it seems that I have not been sure ...
\newcommand*{\PAGENAVI}{%
\indenti\endspancolscell\CLBrk
\indenti\starttr\CLBrk
\ \comment{NAVIGATION COL}\CLBrk
\indentii\FixedWidthCell\pagenavicolwidth
- {\@class{paper} \@valign@t}
-%% %% omitting `\@height{100\%}'
+ {\@class{paper}
+%% <- using `@class'=`paper' here is my brother's idea,
+%% not sure about it ...
+ \@valign@t}
+ %% omitting `\@height{100\%}'
\itemize}
+%% |\PAGEMAINvar{<width>}| closes the navigation column
+%% and opens the ``main content" column. The latter gets
+%% width <width>:
\newcommand*{\PAGEMAINvar}[1]{%
\indentii\enditemize\ \endFixedWidthCell\CLBrk
\ \comment{ MAIN COL }\CLBrk
\indentii\FixedWidthCell{#1}{}}
+%% ... The width may be specified as |\pagemaincolwidth|,
+%% then |\PAGEMAIN| works like `\PAGEMAINvar{\pagemaincolwidth}':
\newcommand*{\PAGEMAIN}{\PAGEMAINvar\pagemaincolwidth}
+%%
+%% === Footer Row ===
+%% |\PAGEFOOT| closes the ``main content" column as well as
+%% the second row, and opens the footer row:
\newcommand*{\PAGEFOOT}{%
\indentii\endFixedWidthCell\CLBrk
% \indentii\tablehspace{96}\CLBrk %% vs. \pagemaincolwidth
@@ -125,12 +206,18 @@
\indenti\endtr\CLBrk
\ \comment{ FOOT ROW / }\CLBrk
\indenti\spancolscell{2}{\@class{paper} \@align@c}%
+%% <- again class ``paper"!?
}
+%% |\PAGEEND| closes the footer row and provides all the rest
+%% ... needed?
\newcommand*{\PAGEEND}{\indenti\endspancolscell\endTable}
-
+%%
+%% == The End and HISTORY ==
\endinput
HISTORY
-2011/09/01 to CTAN as `twocolpg.sty'
-2011/09/02 renamed
+2011/04/29 started (? \if...)
+2011/09/01 to CTAN as `twocolpg.sty'
+2011/09/02 renamed
+2011/10/09f. documentation more serious