/ [latexrefman] / trunk / mirroring.html
To checkout: svn checkout http://svn.gnu.org.ua/sources/latexrefman/trunk/mirroring.html
Puszcza

Contents of /trunk/mirroring.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 711 - (show annotations)
Sun Oct 14 23:13:52 2018 UTC (2 years, 6 months ago) by jimhefferon
File MIME type: text/html
File size: 7050 byte(s)
get pages in place before upload
1 <!DOCTYPE html>
2 <html>
3 <!-- This document is part of the LaTeX2e Unofficial Reference Manual
4 project. For information on the project, including license information, see
5 https://puszcza.gnu.org.ua/software/latexrefman.
6
7 2018-September-22 Jim Hefferon Written -->
8 <head>
9 <meta charset="UTF-8">
10 <title>Mirroring the LaTeX2e unofficial reference manual</title>
11 <meta name="keywords" content="\name (LaTeX2e unofficial reference manual)">
12 <style type="text/css">
13 /* $Id: latex2e.css 690 2018-09-15 15:20:19Z jimhefferon $
14 Minor css for latexrefman. Public domain.
15 Originally written by Jim Hefferon and Karl Berry, 2018. */
16
17 /* So you can style for yourself */
18 @import url("/css/latexreflocal.css");
19
20 a.summary-letter {text-decoration: none}
21 blockquote.indentedblock {margin-right: 0em}
22 blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
23 blockquote.smallquotation {font-size: smaller}
24 div.display {margin-left: 3.2em}
25 div.example {margin-left: 3.2em}
26 div.lisp {margin-left: 3.2em}
27 div.smalldisplay {margin-left: 3.2em}
28 div.smallexample {margin-left: 3.2em}
29 div.smalllisp {margin-left: 3.2em}
30 kbd {font-style: oblique}
31 pre.display {font-family: inherit}
32 pre.format {font-family: inherit}
33 pre.menu-comment {font-family: serif}
34 pre.menu-preformatted {font-family: serif}
35 pre.smalldisplay {font-family: inherit; font-size: smaller}
36 pre.smallexample {font-size: smaller}
37 pre.smallformat {font-family: inherit; font-size: smaller}
38 pre.smalllisp {font-size: smaller}
39 span.nolinebreak {white-space: nowrap}
40 span.roman {font-family: initial; font-weight: normal}
41 span.sansserif {font-family: sans-serif; font-weight: normal}
42 ul.no-bullet {list-style: none}
43 BODY {
44 margin-top: 1em;
45 margin-left: 1em; /* auto results in two-digit <ol> lost off left */
46 margin-right: 1em;
47 margin-bottom: 1em;
48 /* the idea is to use the whole window, unless it is ridiculously
49 wide, probably with too-small fonts, too. */
50 max-width: 64em;
51 }
52
53 /* Because we want @math{... @code ...} to be upright, not slanted,
54 and Texinfo won't fix it. */
55 code {font-style:normal; font-family:monospace; }
56
57 /* We put a link to our own home page at the bottom. */
58 div.referenceinfo {font-size:small;}
59
60 /* CSS for this page */
61 .listitem {font-weight: bold; margin-right: 0.4em; }
62 /* For TeX and LaTeX, Theresa O’Connor tess.oconnor.cx/2007/08/tex-poshlet */
63 /* Use as: <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> */
64 <!-- .tex sub, .latex sub, .latex sup {text-transform: uppercase; } -->
65 <!-- .tex sub, .latex sub {vertical-align: -0.5ex; -->
66 <!-- margin-left: -0.1667em; -->
67 <!-- margin-right: -0.125em; } -->
68 <!-- .tex, .latex, .tex sub, .latex sub {font-size: 1em; } -->
69 <!-- .latex sup {font-size: 0.85em; -->
70 <!-- vertical-align: 0.15em; -->
71 <!-- margin-left: -0.36em; -->
72 <!-- margin-right: -0.15em; } -->
73 </style>
74 </head>
75
76 <body lang="en">
77 <a name="top"></a>
78 <h2 class="section">Mirroring the
79 <i>LaTeX2e Unofficial Reference Manual</i></h2>
80
81 <p>The <i>LaTeX2e Unofficial Reference Manual</i>
82 aims to provide a reference for the user-level commands of LaTeX.
83 For more information, see the
84 <a href="https://puszcza.gnu.org.ua/software/latexrefman">home page</a>.
85 </p>
86
87 <p>It comes in a number of formats, including two HTML formats.
88 One has all the information on
89 <a href="http://latexref.xyz/dev/latex2e.html">a single page</a>.
90 The other has
91 <a href="http://latexref.xyz/">separate pages</a>
92 for each section or subsection.</p>
93
94 <p>If you would like to host either version, or both,
95 whether to have a convenient local copy or to provide a service to the
96 community, that'd be great.
97 The single-page version is easy to search.
98 The many-pages version is more host-friendly
99 since a visitor who only wants one thing doesn't have to get everything.
100 They both have a
101 <a href="https://puszcza.gnu.org.ua/software/latexrefman#license">free license</a>.</p>
102
103 <h3>Directions</h3>
104 <ol>
105 <li><span class="listitem">Install
106 <a href="https://subversion.apache.org/"><i>Subversion</i></a>.</span>
107 Probably you already have it but if not then get it from
108 your system's package manager or from the
109 <a href="https://subversion.apache.org/packages.html"><i>Subversion</i> site</a>.
110 </li>
111
112 <li><span class="listitem">Get the reference manual files.</span>
113 Our project site has
114 <a href="https://puszcza.gnu.org.ua/svn/?group=latexrefman">complete directions</a>
115 but briefly, first create a convenient directory.
116 We'll illustrate with
117 <code>/home/jim/src/latexrefman/</code>.
118 In that directory run
119 <code>svn checkout http://svn.gnu.org.ua/sources/latexrefman/trunk</code>
120 to fetch a subdirectory <code>trunk/</code> with all of the files.
121 </li>
122
123 <li><span class="listitem">Serve the HTML.</span>
124 The files of the many-page version are in
125 <code>trunk/latex2e-help-texinfo-tree/latex2e/</code>.
126 How to display them depends on your web server but the most common case
127 is that you have Apache&nbsp;2 running under Linux.
128 If so, put something like this in the configuration file
129 (perhaps named <code>/etc/apache2/sites-enabled/000-default.conf</code>).
130 <div class="example">
131 <pre class="example">Alias "/latexref" "/home/jim/src/latexrefman/trunk/latex2e-help-texinfo-tree/latex2e"
132 &lt;Directory "/home/jim/src/latexrefman/trunk/latex2e-help-texinfo-tree/latex2e"&gt;
133 Require all granted
134 Options Indexes FollowSymLinks
135 &lt;/Directory&gt;</pre></div>
136 The single-page version is
137 <code>trunk/latex2e.html</code>.
138 Serve it with something like this.
139 <div class="example">
140 <pre class="example">Alias "/latexrefonepage" "/home/jim/src/latexrefman/trunk/latex2e.html"
141 &lt;Directory "/home/jim/src/latexrefman/trunk/"&gt;
142 Require all granted
143 &lt;/Directory&gt;</pre></div>
144 </li>
145
146 <li><span class="listitem">(Optional) Add CSS.</span>
147 The file <code>trunk/latexreflocal.css</code> contains a sample
148 Cascading Style Sheets file to decorate the web pages that you are serving.
149 Adjust it to your taste and then put a copy in your web server's
150 <code>css/</code> directory.
151 </li>
152
153 <li><span class="listitem">Periodically update the files.</span>
154 From the <code>trunk/</code> directory run
155 <code>svn update</code>
156 to get the latest version.
157 Once a week should suffice.
158 You can automate this, for example by using <code>crontab</code>.
159 </li>
160 </ol>
161
162 <p>If you post a version that will stay current then it'd be great if you
163 could let us know about it by mailing <code>latexrefman@tug.org</code>.
164 Thanks!</p>
165
166 <hr/>
167 <div class='referenceinfo'> <a href='https://latexref.xyz/'><i>Unofficial LaTeX2e reference manual</i></a></div>
168 </body>
169 </html>

Send suggestions and bug reports to Sergey Poznyakoff
ViewVC Help
Powered by ViewVC 1.1.20