You can subscribe to this list here.
2001 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(11) |
Dec
(20) |
---|---|---|---|---|---|---|---|---|---|---|---|---|
2002 |
Jan
(48) |
Feb
|
Mar
(10) |
Apr
(35) |
May
(16) |
Jun
(9) |
Jul
(3) |
Aug
(3) |
Sep
(8) |
Oct
(1) |
Nov
(134) |
Dec
|
2003 |
Jan
(3) |
Feb
(1) |
Mar
(26) |
Apr
(3) |
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
2004 |
Jan
(1) |
Feb
(4) |
Mar
(8) |
Apr
(23) |
May
(4) |
Jun
(1) |
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
From: <new...@li...> - 2004-06-30 04:37:55
|
Newbiedoc CVS committal Author : wdt Project : newbiedoc Module : system Dir : newbiedoc/system Modified Files: runlevels-intro.en.sgml Log Message: runlevel is in /sbin, not /etc! =================================================================== RCS file: /cvsroot/newbiedoc/newbiedoc/system/runlevels-intro.en.sgml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -3 -r1.1 -r1.2 --- runlevels-intro.en.sgml 21 Nov 2002 15:54:04 -0000 1.1 +++ runlevels-intro.en.sgml 30 Jun 2004 04:37:49 -0000 1.2 @@ -337,7 +337,7 @@ <para>How do you find out which runlevel you're in right now? This one's easy. Try this:</para> - <screen>$ <command>/etc/runlevel</command> + <screen>$ <command>/sbin/runlevel</command> S 2</screen> <para>It displays both the previous runlevel (which may be S |
From: <new...@li...> - 2004-05-11 14:53:23
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/cpan.en Added Files: a379.html.en a440.html.en sec-document-conventions.html.en sec-other-debian-packages.html.en t1.html.en x100.html.en x112.html.en x150.html.en x161.html.en x164.html.en x168.html.en x28.html.en x305.html.en x351.html.en x360.html.en x381.html.en x385.html.en x389.html.en x39.html.en x395.html.en x62.html.en x81.html.en Log Message: ---------------------------------------------------------------------- Chris Lale committing in newbiedoc/networking web/networking web/tutorials/cpan.en Added Files: newbiedoc/networking/cpan.en.lyx newbiedoc/networking/cpan.en.sgml web/networking/cpan.html.en web/tutorials/cpan.en/*.html.en ---------------------------------------------------------------------- ---------------------------------------------------------------------- Added Files: web/networking/cpan.html.en web/tutorials/cpan.en/a379.html.en web/tutorials/cpan.en/a440.html.en web/tutorials/cpan.en/sec-document-conventions.html.en web/tutorials/cpan.en/sec-other-debian-packages.html.en web/tutorials/cpan.en/t1.html.en web/tutorials/cpan.en/x100.html.en web/tutorials/cpan.en/x112.html.en web/tutorials/cpan.en/x150.html.en web/tutorials/cpan.en/x161.html.en web/tutorials/cpan.en/x164.html.en web/tutorials/cpan.en/x168.html.en web/tutorials/cpan.en/x28.html.en web/tutorials/cpan.en/x305.html.en web/tutorials/cpan.en/x351.html.en web/tutorials/cpan.en/x360.html.en web/tutorials/cpan.en/x381.html.en web/tutorials/cpan.en/x385.html.en web/tutorials/cpan.en/x389.html.en web/tutorials/cpan.en/x39.html.en web/tutorials/cpan.en/x395.html.en web/tutorials/cpan.en/x62.html.en web/tutorials/cpan.en/x81.html.en ---------------------------------------------------------------------- |
From: <new...@li...> - 2004-05-11 14:53:22
|
Newbiedoc CVS committal Author : chrislale Project : web Module : networking Dir : web/networking Added Files: cpan.html.en Log Message: ---------------------------------------------------------------------- Chris Lale committing in newbiedoc/networking web/networking web/tutorials/cpan.en Added Files: newbiedoc/networking/cpan.en.lyx newbiedoc/networking/cpan.en.sgml web/networking/cpan.html.en web/tutorials/cpan.en/*.html.en ---------------------------------------------------------------------- ---------------------------------------------------------------------- Added Files: web/networking/cpan.html.en web/tutorials/cpan.en/a379.html.en web/tutorials/cpan.en/a440.html.en web/tutorials/cpan.en/sec-document-conventions.html.en web/tutorials/cpan.en/sec-other-debian-packages.html.en web/tutorials/cpan.en/t1.html.en web/tutorials/cpan.en/x100.html.en web/tutorials/cpan.en/x112.html.en web/tutorials/cpan.en/x150.html.en web/tutorials/cpan.en/x161.html.en web/tutorials/cpan.en/x164.html.en web/tutorials/cpan.en/x168.html.en web/tutorials/cpan.en/x28.html.en web/tutorials/cpan.en/x305.html.en web/tutorials/cpan.en/x351.html.en web/tutorials/cpan.en/x360.html.en web/tutorials/cpan.en/x381.html.en web/tutorials/cpan.en/x385.html.en web/tutorials/cpan.en/x389.html.en web/tutorials/cpan.en/x39.html.en web/tutorials/cpan.en/x395.html.en web/tutorials/cpan.en/x62.html.en web/tutorials/cpan.en/x81.html.en ---------------------------------------------------------------------- |
From: <new...@li...> - 2004-05-11 14:50:41
|
Newbiedoc CVS committal Author : chrislale Project : newbiedoc Module : networking Dir : newbiedoc/networking Added Files: cpan.en.lyx cpan.en.sgml Log Message: ---------------------------------------------------------------------- Chris Lale committing in newbiedoc/networking web/networking web/tutorials/cpan.en Added Files: newbiedoc/networking/cpan.en.lyx newbiedoc/networking/cpan.en.sgml web/networking/cpan.html.en web/tutorials/cpan.en/*.html.en ---------------------------------------------------------------------- |
From: <new...@li...> - 2004-05-11 14:39:56
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/cpan.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/cpan.en added to the repository |
From: <new...@li...> - 2004-04-30 21:50:47
|
Newbiedoc CVS committal Author : chrislale Project : web Module : networking Dir : web/networking Added Files: spam.html.en Log Message: spam.en re-try |
From: <new...@li...> - 2004-04-30 21:50:44
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/spam.en Added Files: sec-document-conventions.html.en t1.html.en x1063.html.en x1074.html.en x1078.html.en x1082.html.en x1087.html.en x1132.html.en x27.html.en x365.html.en x507.html.en x590.html.en x866.html.en x982.html.en Log Message: spam.en re-try |
From: <new...@li...> - 2004-04-30 21:50:44
|
Newbiedoc CVS committal Author : chrislale Project : newbiedoc Module : networking Dir : newbiedoc/networking Added Files: spam.en.lyx spam.en.sgml Log Message: spam.en re-try |
From: <new...@li...> - 2004-04-30 21:50:44
|
Newbiedoc CVS committal Author : chrislale Project : web Module : images Dir : web/images/spam.en Added Files: spam0-generic.png spam00-outgoing.png spam1-evolution.png spam1b-exim-procmail.png spam2-fetchmail.png spam3-assassin.png spam4-complete.png Log Message: spam.en re-try |
From: <new...@li...> - 2004-04-30 15:15:45
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/images/spam.en Added Files: spam0-generic.png spam00-outgoing.png spam1-evolution.png spam1b-exim-procmail.png spam2-fetchmail.png spam3-assassin.png spam4-complete.png Log Message: ---------------------------------------------------------------------- Chris Lale Committing fiels and directories for spam.en in newbiedoc/networking/ web/images/ web/networking/ web/tutorials/spam.en/ web/tutorials/images/spam.en/ ---------------------------------------------------------------------- |
From: <new...@li...> - 2004-04-30 14:53:51
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/images/spam.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/images/spam.en added to the repository |
From: <new...@li...> - 2004-04-30 14:51:07
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/spam.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/spam.en added to the repository |
From: <new...@li...> - 2004-04-30 14:47:16
|
Newbiedoc CVS committal Author : chrislale Project : web Module : images Dir : web/images/spam.en Log Message: Directory /cvsroot/newbiedoc/web/images/spam.en added to the repository |
From: <new...@li...> - 2004-04-28 16:51:52
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tarballs Dir : web/tarballs Added Files: newbiedoc-lyx-files_0.02.tar.gz Log Message: ---------------------------------------------------------------------- Chris Lale committing in web/tarballs. Added Files: newbiedoc-lyx-files_0.02.tar.gz ---------------------------------------------------------------------- |
From: <new...@li...> - 2004-04-28 16:43:51
|
Newbiedoc CVS committal Author : chrislale Project : newbiedoc Module : metadoc Dir : newbiedoc/metadoc Modified Files: newbiedoc-lyx-quick-guide.en.lyx newbiedoc-lyx-quick-guide.en.sgml Added Files: newbiedoc-lyx-reference.en.lyx newbiedoc-lyx-reference.en.sgml Log Message: ---------------------------------------------------------------------- Chris Lale committing source files in newbiedoc/metadoc Modified Files: newbiedoc-lyx-quick-guide.en.lyx newbiedoc-lyx-quick-guide.en.sgml Added Files: newbiedoc-lyx-reference.en.lyx newbiedoc-lyx-reference.en.sgml ---------------------------------------------------------------------- =================================================================== RCS file: /cvsroot/newbiedoc/newbiedoc/metadoc/newbiedoc-lyx-quick-guide.en.lyx,v retrieving revision 1.3 retrieving revision 1.4 diff -u -3 -r1.3 -r1.4 --- newbiedoc-lyx-quick-guide.en.lyx 12 Mar 2004 16:44:11 -0000 1.3 +++ newbiedoc-lyx-quick-guide.en.lyx 28 Apr 2004 16:43:38 -0000 1.4 @@ -27,7 +27,7 @@ \layout SGML <!--newbiedoc-lyx-template.en.lyx, newbiedoc-lyx-template.en.sgml, Copyright - (c) March2004 Chris Lale <fee...@co...>. + (c) March2004 Chris Lale <chrislale AT coolscience DOT co DOT uk>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 @@ -66,7 +66,7 @@ \layout Email -fe...@co... +ch...@us... \layout RevisionHistory \layout Revision @@ -202,7 +202,7 @@ \end_inset in the usual way. - The process described in this document is known to work + The instructions in this document are known to work \begin_inset ERT status Collapsed @@ -942,7 +942,24 @@ System-wide installation as user Root \layout Standard -Copy the files to +Installed this way, all users will be able to use these +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +lyx +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + layouts. + Copy the files to \begin_inset ERT status Collapsed @@ -983,7 +1000,24 @@ Local installation as a normal user \layout Standard -Exit from user Root first, thencopy the files to +Installed this way, only the user installing the +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +lyx +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + layouts will have access to them. + Exit from user Root first, then copy the files to \begin_inset ERT status Collapsed @@ -1216,49 +1250,10 @@ /newbiedoc-lyx-template.en.lyx ~/.lyx/templates \layout Subsection -HTML style-sheet nd-style.css -\layout Standard - -You must be user Root to install this style sheet. -\layout Standard - -NewbieDoc HTML pages look for a CSS style sheet (named nd-style.css) in the - root directory. - The root directory is either the system's root (/), or the document directory - (eg -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -/var/www/ -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - -) if you are viewing web pages via a web server. - The HTML produced by -\begin_inset ERT -status Collapsed - +CSS styles \layout Standard -<application> -\end_inset -lyx/sgmltools -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - needs an enhanced version of the newbieDoc CSS style sheet ( +NewbieDoc HTML pages look for a CSS style sheet (named \begin_inset ERT status Collapsed @@ -1274,13 +1269,9 @@ </filename> \end_inset -). -\layout Subsubsection - -Quick and dirty solution -\layout Standard - -If you are in a hurry, just copy +) in the root directory. + The root directory is either the system's root (/), or the document directory + (eg \begin_inset ERT status Collapsed @@ -1288,7 +1279,7 @@ <filename> \end_inset -html-css-stylesheet/nd-style.css +/var/www/ \begin_inset ERT status Collapsed @@ -1296,83 +1287,35 @@ </filename> \end_inset - to your system's root. - (You must be user Root to do this.) -\layout Standard - -First move any existing version out of the way. - This is preferable to deleting it! -\layout Screen - -# -\begin_inset ERT -status Collapsed - -\layout Standard -<command> -\end_inset - -mv -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset - - /nd-style.css /nd-style.css.orig -\layout Standard - -Now copy the replacement style sheet to root. +) if you are viewing web pages via a web server. -\layout Screen - -# -\begin_inset ERT -status Collapsed - \layout Standard -<command> -\end_inset -cp -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset +The newbieDoc Lyx styles use some extra CSS styles not available in the + current version of nd-style.css. + The extra styles are +\layout Itemize - newbiedoc-lyx-files_n.nn/html-css-stylesheet/nd-style.css / -\layout Subsubsection +command (bold) +\layout Itemize -A more elegant solution -\layout Standard +filename (monospace) +\layout Itemize -This method uses -\begin_inset ERT -status Collapsed +application (smallcaps) +\layout Itemize +xscreen (similar to screen but with sans-serif font) \layout Standard -<application> -\end_inset - -update-alternatives -\begin_inset ERT -status Collapsed -\layout Standard -</application> -\end_inset +If you want to use these extra styles, you must hard-code them into your + final HTML files. +\layout Subsubsection -. - It enables you to have more than one file with the same name. - This is especially useful if you wish to keep an existing version of nd-style.cs -s. +Hard-coding the extra styles into the final HTML file \layout Standard -Move any existing version out of the way and copy the replacement style - sheet to root with its name changed to +Open the HTML file in a text editor and find \begin_inset ERT status Collapsed @@ -1380,332 +1323,103 @@ <filename> \end_inset -nd-style.css.lyx +<LINK REL="STYLESHEET" TYPE="text/css" HREF="/nd-style.css"> \begin_inset ERT -status Collapsed +status Open \layout Standard </filename> \end_inset . -\layout Screen - -# -\begin_inset ERT -status Collapsed - -\layout Standard -<command> -\end_inset - -mv -\begin_inset ERT -status Collapsed - + Insert the text below immediately after it. \layout Standard -</command> -\end_inset -/nd-style.css /nd-style.css.orig +This is the code immediately before the inserted text. \layout Screen -# -\begin_inset ERT -status Collapsed - -\layout Standard -<command> -\end_inset - -cp -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset - -html-css-stylesheet/nd-style.css /nd-style.css.lyx -\layout Standard - -Install -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -nd-style.css.lyx -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - - as the first alternative to -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -nd-style.css -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - -. - Create a link ( -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -nd-style.css -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - -) in -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -/etc/alternatives -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - - which points to -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -/nd-style.css.lyx -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - - with priority 6. - + "><LINK \layout Screen -# -\begin_inset ERT -status Collapsed - -\layout Standard -<command> -\end_inset - -update-alternatives -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset - - --verbose --install -\backslash - +REL="STYLESHEET" \layout Screen -/nd-style.css nd-style.css /nd-style.css.lyx 6 -\layout Standard - -Check the link +TYPE="text/css" \layout Screen -# -\begin_inset ERT -status Collapsed - +HREF="/nd-style.css"> \layout Standard -<command> -\end_inset - -update-alternatives -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset - - --verbose --display -\backslash +Insert this extra HTML code. \layout Screen -nd-style.css -\newline - -\newline -... - -\newline - -\newline - +<!-- Extra styles needed for LyX-generated newbieDoc html files --> \layout Screen -Current `best' version is /nd-style.css.lyx -\layout Standard - -Install -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -nd-style.css.orig -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - - as the second alternative to -\begin_inset ERT -status Collapsed - -\layout Standard -<filename> -\end_inset - -nd-style.css -\begin_inset ERT -status Collapsed - -\layout Standard -</filename> -\end_inset - -. - Create a link to the second alternative with a priority less than 6. - +<STYLE TYPE="text/css"> \layout Screen -# -\begin_inset ERT -status Collapsed - -\layout Standard -<command> -\end_inset - -update-alternatives -\begin_inset ERT -status Collapsed - -\layout Standard -</command> -\end_inset - - --verbose --install -\backslash - +<!-- \layout Screen -/nd-style.css nd-style.css /nd-style.css.orig 4 -\layout Standard - -Check the alternatives are configured correctly. - The current default version is tagged with a '*'. - +b.COMMAND {font-style:bold;} \layout Screen -# -\begin_inset ERT -status Collapsed +tt.FILENAME {font-family: monospace;} +\layout Screen -\layout Standard -<command> -\end_inset +SPAN.APPLICATION {font-variant: small-caps;} +\layout Screen -update-alternatives -\begin_inset ERT -status Collapsed +PRE.SYNOPSIS { +\layout Screen -\layout Standard -</command> -\end_inset + background-color: #ffffcc; +\layout Screen - --verbose --config -\backslash + border:solid; +\layout Screen + border-color: #009999; \layout Screen -/nd-style.css -\newline + border-left: solid #009999 20px; +\layout Screen -\newline -There are 2 programs which provide `/nd-style.css'. + border-right: solid #009999 0px; \layout Screen - Selection Command + border-top: solid #009999 0px; \layout Screen ------------------------------------------------ + border-bottom: solid #009999 0px; \layout Screen -*+ 1 /nd-style.css.lyx + padding-left: 15pt; \layout Screen - 2 /nd-style.css.orig -\newline + font-family: sans-serif; +\layout Screen -\newline -Enter to keep the default[*], or type selection number: -\begin_inset ERT -status Collapsed + } +\layout Screen -\layout Standard -<command> -\end_inset +//--> +\layout Screen -1 -\begin_inset ERT -status Collapsed +</STYLE> +\layout Screen +<!-- End of extra styles needed for LyX-generated newbieDoc html files --> \layout Standard -</command> -\end_inset - +This is the code immediately after the inserted text. \layout Screen -# +</HEAD \layout Screen +><BODY \layout Subsection Making the newbieDoc styles available in @@ -1784,13 +1498,25 @@ \emph on -Menu bar -\layout XScreen +Menu bar: +\emph default + +\begin_inset ERT +status Collapsed - Edit -\layout XScreen +\layout Standard +<command> +\end_inset + +Edit +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset - + -> \begin_inset ERT status Collapsed @@ -1812,13 +1538,25 @@ \newline \emph on -Menu bar -\layout XScreen +Menu bar: +\emph default + +\begin_inset ERT +status Collapsed - File -\layout XScreen +\layout Standard +<command> +\end_inset - +File +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> \begin_inset ERT status Collapsed @@ -2036,18 +1774,14 @@ </application> \end_inset -'s menu bar: +'s menu bar. \layout XScreen \emph on -Menu bar -\layout XScreen - - File -\layout XScreen - - +Menu bar: +\emph default + \begin_inset ERT status Collapsed @@ -2055,7 +1789,7 @@ <command> \end_inset -New from Template +File \begin_inset ERT status Collapsed @@ -2063,13 +1797,23 @@ </command> \end_inset + -> +\begin_inset ERT +status Collapsed -\layout XScreen +\layout Standard +<command> +\end_inset - newbiedoc-lyx-template.lyx -\layout XScreen +New from Template +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset - + -> newbiedoc-lyx-template.lyx -> \begin_inset ERT status Collapsed @@ -2286,16 +2030,16 @@ \layout Standard Select 'Section' from the list of styles. + The drop-down styles list is the left-most button in the button bar. Enter the title 'Hello world message' (without the quotes) and press the - <ENTER> key: + <ENTER> key. \layout XScreen \emph on Drop-down styles list -\layout XScreen - - +\emph default +: \begin_inset ERT status Collapsed @@ -2315,7 +2059,11 @@ \newline \newline - Hello world message + +\emph on +LyX main window: +\emph default + Hello world message \layout Standard Enter a short paragraph using the Standard style. @@ -2324,9 +2072,8 @@ \emph on -Drop-down styles list -\layout XScreen - +Drop-down styles list: +\emph default \begin_inset ERT status Collapsed @@ -2347,7 +2094,11 @@ \newline \newline - Hello world! + +\emph on +LyX main window: +\emph default + Hello world! \layout Standard That's it! Remember to save the file (hello-world.en.lyx). @@ -2355,13 +2106,9 @@ \emph on -Menu bar -\layout XScreen - - File -\layout XScreen - - +Menu bar: +\emph default + \begin_inset ERT status Collapsed @@ -2369,7 +2116,7 @@ <command> \end_inset -Save +File \begin_inset ERT status Collapsed @@ -2377,13 +2124,23 @@ </command> \end_inset + -> +\begin_inset ERT +status Collapsed -\layout XScreen +\layout Standard +<command> +\end_inset - hello-world.en -\layout XScreen +Save +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset - + -> hello-world.en -> \begin_inset ERT status Collapsed @@ -2427,16 +2184,41 @@ \emph on -Menu bar -\layout XScreen +Menu bar: +\emph default + +\begin_inset ERT +status Collapsed - File -\layout XScreen +\layout Standard +<command> +\end_inset - Export -\layout XScreen +File +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +Export +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset - + -> \begin_inset ERT status Collapsed @@ -3000,8 +2782,56 @@ \emph on -Web page: +Web browser \emph default +: +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +File +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +Open +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> hello-world.en.html -> +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +OK +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + \newline @@ -3080,8 +2910,40 @@ \emph on -Web page: +Web browser: \emph default + +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +View +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +Reload +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + \newline @@ -3168,29 +3030,12 @@ </application> \end_inset - reference might be a good starting place. -\layout WarningTitle - -The newbieDoc -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lyx -\begin_inset ERT -status Collapsed + reference might be a good starting place ( +\begin_inset LatexCommand \url[http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html]{http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html} -\layout Standard -</application> \end_inset - reference -\layout Warning - -I am still writing this. +). \layout Standard Good Luck! If you found this document useful, please let me know @@ -3241,7 +3086,16 @@ Bugs, errors and mistakes \layout Standard -If you find any errors, omissions etc, please let me know +If you find any errors, omissions etc, please let me know via the newbieDoc + Discussion list +\begin_inset ERT +status Collapsed + +\layout Standard +<email>new...@li...</email> +\end_inset + + or \begin_inset ERT status Collapsed @@ -3256,21 +3110,8 @@ \layout Standard I have written this document in English. - I have used American spellings for some technical terms eg 'dialog', 'disk' - and 'program' where these have become widely accepted. -\layout Standard - -Deciding how to use program names and package names at the beginning of - a sentence is always a problem. - Sentences should always begin with a capital letter, but program names - and package names usually begin with a lower-case letter. - I was ploughing through some man pages one day when I noticed that the - program name often appeared in capital letters at the top, left-hand corner. - I have taken a similar approach. - In the source document I write program names and package names in lower - case. - I tag them so that they are rendered in a 'small caps' font in the final - document. + I have used American spellings for some technical terms eg 'program' where + these have become widely accepted. \layout Standard You can find guides to English spelling, punctuation and grammar at @@ -3281,9 +3122,44 @@ . \layout Section + +\begin_inset LatexCommand \label{sec-Document-conventions} + +\end_inset + Conventions used in this document \layout Subsection +Ellipsis +\layout Standard + +Three dots ... + +\layout Itemize + +if before text, indicates text has been omitted in front of the text +\layout Itemize + +if after text, indicates that following text has been omitted. +\layout Itemize + +if on one line by themselves indicates that lines have been omitted. +\layout Subsection + +Directory trees +\layout Standard + +A trailing forward slash ( +\begin_inset ERT +status Collapsed + +\layout Standard +/ +\end_inset + +) indicates that this is a directory, not a file. +\layout Subsection + Command line prompts \layout Standard @@ -3350,6 +3226,12 @@ my-file.txt \layout Screen +my-directory +\layout Screen + +/my-path/my-directory/ +\layout Screen + \begin_inset ERT status Collapsed @@ -3443,7 +3325,7 @@ \layout Standard Commands issued from a terminal look like this. - Use of the <Enter> key is implied but not shown. + Use of the <ENTER> key is implied but not shown. \layout Screen $ @@ -3465,18 +3347,30 @@ \layout Standard -The 3rd line in this example shows a command issued in X. +This example shows a command issued in an X application. \layout XScreen \emph on -Menu bar -\layout XScreen +Menu bar: +\emph default + +\begin_inset ERT +status Collapsed - File -\layout XScreen +\layout Standard +<command> +\end_inset + +File +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset - + -> \begin_inset ERT status Collapsed @@ -3493,6 +3387,4 @@ \end_inset -\layout XScreen - \the_end =================================================================== RCS file: /cvsroot/newbiedoc/newbiedoc/metadoc/newbiedoc-lyx-quick-guide.en.sgml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -3 -r1.3 -r1.4 --- newbiedoc-lyx-quick-guide.en.sgml 12 Mar 2004 16:44:11 -0000 1.3 +++ newbiedoc-lyx-quick-guide.en.sgml 28 Apr 2004 16:43:38 -0000 1.4 @@ -6,7 +6,7 @@ <!-- DocBook file was created by LyX 1.3 See http://www.lyx.org/ for more information --> -<!--newbiedoc-lyx-template.en.lyx, newbiedoc-lyx-template.en.sgml, Copyright (c) March2004 Chris Lale <fee...@co...>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. --> +<!--newbiedoc-lyx-template.en.lyx, newbiedoc-lyx-template.en.sgml, Copyright (c) March2004 Chris Lale <chrislale AT coolscience DOT co DOT uk>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. --> <title> Quick guide to writing newbieDoc articles using @@ -27,7 +27,7 @@ <address> <email> -fe...@co... +ch...@us... </email> </address> @@ -80,7 +80,7 @@ <abstract> <para> -<application>lyx</application> is a WYSIWYM (What You See Is What You Mean) document processor. If you can use a word processor you can use <application>lyx</application>. <application>lyx</application> is normally used to create <application>LaTeX</application> documents, but you can export documents to DocBook SGML format or DocBook XML format. This document describes the use of <application>lyx</application> to produce newbieDoc DocBook SGML. The exported SGML can be rendered into HTML using <application>sgmltools-lite</application> in the usual way. The process described in this document is known to work <application>lyx</application> version 1.3.3 running in Debian 3.0 (Woody). +<application>lyx</application> is a WYSIWYM (What You See Is What You Mean) document processor. If you can use a word processor you can use <application>lyx</application>. <application>lyx</application> is normally used to create <application>LaTeX</application> documents, but you can export documents to DocBook SGML format or DocBook XML format. This document describes the use of <application>lyx</application> to produce newbieDoc DocBook SGML. The exported SGML can be rendered into HTML using <application>sgmltools-lite</application> in the usual way. The instructions in this document are known to work <application>lyx</application> version 1.3.3 running in Debian 3.0 (Woody). </para> </abstract> @@ -240,7 +240,7 @@ System-wide installation as user Root </title> <para> -Copy the files to <filename>/usr/share/lyx/layouts/</filename>. +Installed this way, all users will be able to use these <application>lyx</application> layouts. Copy the files to <filename>/usr/share/lyx/layouts/</filename>. </para> <screen> <![CDATA[# ]]><command><![CDATA[cp]]></command><![CDATA[ newbiedoc-lyx-files_n.nn/lyx-layout-files/* /usr/share/lyx/layouts/ @@ -254,7 +254,7 @@ Local installation as a normal user </title> <para> -Exit from user Root first, thencopy the files to <filename>˜/.lyx/layouts/</filename>. +Installed this way, only the user installing the <application>lyx</application> layouts will have access to them. Exit from user Root first, then copy the files to <filename>˜/.lyx/layouts/</filename>. </para> <screen> <![CDATA[# ]]><command><![CDATA[exit]]></command><![CDATA[ @@ -317,98 +317,93 @@ <sect2> <title> -HTML style-sheet nd-style.css +CSS styles </title> <para> -You must be user Root to install this style sheet. +NewbieDoc HTML pages look for a CSS style sheet (named <filename>nd-style.css</filename>) in the root directory. The root directory is either the system's root (/), or the document directory (eg <filename>/var/www/</filename>) if you are viewing web pages via a web server. </para> <para> -NewbieDoc HTML pages look for a CSS style sheet (named nd-style.css) in the root directory. The root directory is either the system's root (/), or the document directory (eg <filename>/var/www/</filename>) if you are viewing web pages via a web server. The HTML produced by <application>lyx/sgmltools</application> needs an enhanced version of the newbieDoc CSS style sheet (<filename>nd-style.css</filename>). +The newbieDoc Lyx styles use some extra CSS styles not available in the current version of nd-style.css. The extra styles are </para> - <sect3> - <title> -Quick and dirty solution - </title> + <itemizedlist> + <listitem> <para> -If you are in a hurry, just copy <filename>html-css-stylesheet/nd-style.css</filename> to your system's root. (You must be user Root to do this.) +command (bold) </para> + + </listitem> + <listitem> <para> -First move any existing version out of the way. This is preferable to deleting it! +filename (monospace) </para> - <screen> -<![CDATA[# ]]><command><![CDATA[mv]]></command><![CDATA[ /nd-style.css /nd-style.css.orig -]]> - </screen> + + </listitem> + <listitem> <para> -Now copy the replacement style sheet to root. +application (smallcaps) </para> - <screen> -<![CDATA[# ]]><command><![CDATA[cp]]></command><![CDATA[ newbiedoc-lyx-files_n.nn/html-css-stylesheet/nd-style.css / -]]> - </screen> - </sect3> + </listitem> + <listitem> + <para> +xscreen (similar to screen but with sans-serif font) + </para> + </listitem> + + </itemizedlist> + <para> +If you want to use these extra styles, you must hard-code them into your final HTML files. + </para> <sect3> <title> -A more elegant solution +Hard-coding the extra styles into the final HTML file </title> <para> -This method uses <application>update-alternatives</application>. It enables you to have more than one file with the same name. This is especially useful if you wish to keep an existing version of nd-style.css. - </para> - <para> -Move any existing version out of the way and copy the replacement style sheet to root with its name changed to <filename>nd-style.css.lyx</filename>. - </para> - <screen> -<![CDATA[# ]]><command><![CDATA[mv]]></command><![CDATA[/nd-style.css /nd-style.css.orig -]]><![CDATA[# ]]><command><![CDATA[cp]]></command><![CDATA[html-css-stylesheet/nd-style.css /nd-style.css.lyx -]]> - </screen> - <para> -Install <filename>nd-style.css.lyx</filename> as the first alternative to <filename>nd-style.css</filename>. Create a link (<filename>nd-style.css</filename>) in <filename>/etc/alternatives</filename> which points to <filename>/nd-style.css.lyx</filename> with priority 6. +Open the HTML file in a text editor and find <filename><LINK REL="STYLESHEET" TYPE="text/css" HREF="/nd-style.css"></filename>. Insert the text below immediately after it. </para> - <screen> -<![CDATA[# ]]><command><![CDATA[update-alternatives]]></command><![CDATA[ --verbose --install \ -]]><![CDATA[/nd-style.css nd-style.css /nd-style.css.lyx 6 -]]> - </screen> <para> -Check the link +This is the code immediately before the inserted text. </para> <screen> -<![CDATA[# ]]><command><![CDATA[update-alternatives]]></command><![CDATA[ --verbose --display \ -]]><![CDATA[nd-style.css - -... - - -]]><![CDATA[Current `best' version is /nd-style.css.lyx +<![CDATA[ "><LINK +]]><![CDATA[REL="STYLESHEET" +]]><![CDATA[TYPE="text/css" +]]><![CDATA[HREF="/nd-style.css"> ]]> </screen> <para> -Install <filename>nd-style.css.orig</filename> as the second alternative to <filename>nd-style.css</filename>. Create a link to the second alternative with a priority less than 6. +Insert this extra HTML code. </para> <screen> -<![CDATA[# ]]><command><![CDATA[update-alternatives]]></command><![CDATA[ --verbose --install \ -]]><![CDATA[/nd-style.css nd-style.css /nd-style.css.orig 4 +<![CDATA[<!-- Extra styles needed for LyX-generated newbieDoc html files --> +]]><![CDATA[<STYLE TYPE="text/css"> +]]><![CDATA[<!-- +]]><![CDATA[b.COMMAND {font-style:bold;} +]]><![CDATA[tt.FILENAME {font-family: monospace;} +]]><![CDATA[SPAN.APPLICATION {font-variant: small-caps;} +]]><![CDATA[PRE.SYNOPSIS { +]]><![CDATA[ background-color: #ffffcc; +]]><![CDATA[ border:solid; +]]><![CDATA[ border-color: #009999; +]]><![CDATA[ border-left: solid #009999 20px; +]]><![CDATA[ border-right: solid #009999 0px; +]]><![CDATA[ border-top: solid #009999 0px; +]]><![CDATA[ border-bottom: solid #009999 0px; +]]><![CDATA[ padding-left: 15pt; +]]><![CDATA[ font-family: sans-serif; +]]><![CDATA[ } +]]><![CDATA[//--> +]]><![CDATA[</STYLE> +]]><![CDATA[<!-- End of extra styles needed for LyX-generated newbieDoc html files --> ]]> </screen> <para> -Check the alternatives are configured correctly. The current default version is tagged with a '*'. +This is the code immediately after the inserted text. </para> <screen> -<![CDATA[# ]]><command><![CDATA[update-alternatives]]></command><![CDATA[ --verbose --config \ -]]><![CDATA[/nd-style.css - -There are 2 programs which provide `/nd-style.css'. -]]><![CDATA[ Selection Command -]]><![CDATA[----------------------------------------------- -]]><![CDATA[*+ 1 /nd-style.css.lyx -]]><![CDATA[ 2 /nd-style.css.orig - -Enter to keep the default[*], or type selection number: ]]><command><![CDATA[1]]></command><![CDATA[ -]]><![CDATA[# -]]><![CDATA[ +<![CDATA[</HEAD +]]><![CDATA[><BODY ]]> </screen> @@ -425,13 +420,9 @@ When you have finished copying the files to their destinations, run <application>lyx</application>. Reconfigure the new configuration using Edit &lyxarrow; Reconfigure from the menu bar, exit <application>lyx</application> and run a new instance of <application>lyx</application>. Thats it! </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ Edit -]]><![CDATA[ ]]><command><![CDATA[Reconfigure]]></command><![CDATA[ - -]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ ]]><command><![CDATA[Exit]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Menu bar: ]]></emphasis><![CDATA[ ]]><command><![CDATA[Edit]]></command><![CDATA[ -> ]]><command><![CDATA[Reconfigure]]></command><![CDATA[ + +]]><emphasis><![CDATA[Menu bar:]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ ->]]><command><![CDATA[Exit]]></command><![CDATA[ ]]><![CDATA[ ]]><![CDATA[ ]]> @@ -490,14 +481,10 @@ Getting started using a newbieDoc template </title> <para> -Open a new document from <application>lyx</application>'s menu bar: +Open a new document from <application>lyx</application>'s menu bar. </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ ]]><command><![CDATA[New from Template]]></command><![CDATA[ -]]><![CDATA[ newbiedoc-lyx-template.lyx -]]><![CDATA[ ]]><command><![CDATA[OK ]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Menu bar:]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[New from Template]]></command><![CDATA[ -> newbiedoc-lyx-template.lyx -> ]]><command><![CDATA[OK ]]></command><![CDATA[ ]]> </synopsis> @@ -603,34 +590,28 @@ This is how to produce a simple article with only one section and one paragraph of standard text. Position the insertion point (flashing vertical bar) at the end of the document. Create a new line by pressing the <ENTER> key. </para> <para> -Select 'Section' from the list of styles. Enter the title 'Hello world message' (without the quotes) and press the <ENTER> key: +Select 'Section' from the list of styles. The drop-down styles list is the left-most button in the button bar. Enter the title 'Hello world message' (without the quotes) and press the <ENTER> key. </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Drop-down styles list]]></emphasis><![CDATA[ -]]><![CDATA[ ]]><command><![CDATA[Section]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Drop-down styles list]]></emphasis><![CDATA[: ]]><command><![CDATA[Section]]></command><![CDATA[ - Hello world message +]]><emphasis><![CDATA[LyX main window:]]></emphasis><![CDATA[ Hello world message ]]> </synopsis> <para> Enter a short paragraph using the Standard style. (Standard is the default style, so just go ahead and type.) </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Drop-down styles list]]></emphasis><![CDATA[ -]]><![CDATA[ ]]><command><![CDATA[Standard]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Drop-down styles list:]]></emphasis><![CDATA[ ]]><command><![CDATA[Standard]]></command><![CDATA[ - Hello world! +]]><emphasis><![CDATA[LyX main window: ]]></emphasis><![CDATA[ Hello world! ]]> </synopsis> <para> That's it! Remember to save the file (hello-world.en.lyx). </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ ]]><command><![CDATA[Save]]></command><![CDATA[ -]]><![CDATA[ hello-world.en -]]><![CDATA[ ]]><command><![CDATA[Save]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Menu bar:]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[Save]]></command><![CDATA[ -> hello-world.en -> ]]><command><![CDATA[Save]]></command><![CDATA[ ]]> </synopsis> @@ -644,10 +625,7 @@ Generate DocBook SGML using <application>lyx</application>'s 'Export' command. From the menu bar: </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ Export -]]><![CDATA[ ]]><command><![CDATA[DocBook]]></command><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Menu bar:]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[Export]]></command><![CDATA[ -> ]]><command><![CDATA[DocBook]]></command><![CDATA[ ]]> </synopsis> <para> @@ -732,7 +710,7 @@ The result is another file in your working directory. The new file is <filename>hello-world.en.html</filename> and you can view it in a web browser. The HTML article has only one section: “Hello world message”. </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Web page:]]></emphasis><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Web browser]]></emphasis><![CDATA[: ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[Open]]></command><![CDATA[ -> hello-world.en.html -> ]]><command><![CDATA[OK]]></command><![CDATA[ ]]><command><![CDATA[Hello world message]]></command><![CDATA[ ]]><![CDATA[Hello world! @@ -756,7 +734,7 @@ The new web page should now include a table of contents. </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Web page:]]></emphasis><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Web browser:]]></emphasis><![CDATA[ ]]><command><![CDATA[View]]></command><![CDATA[ -> ]]><command><![CDATA[Reload]]></command><![CDATA[ Table of Contents ]]><![CDATA[1. ]]><link linkend="sec-Generate-HTML-using">Hello world message</link><![CDATA[ @@ -775,17 +753,8 @@ What next? </title> <para> -You should now be able to produce a basic newbieDoc article quickly and easily. I expect that you will soon want to use other layouts and some in-line elements in your documents. (<application>lyx</application> handles some inline elements well eg URL links, tables and graphics. It is not so good with filename, command or application.) The newbieDoc <application>lyx</application> reference might be a good starting place. +You should now be able to produce a basic newbieDoc article quickly and easily. I expect that you will soon want to use other layouts and some in-line elements in your documents. (<application>lyx</application> handles some inline elements well eg URL links, tables and graphics. It is not so good with filename, command or application.) The newbieDoc <application>lyx</application> reference might be a good starting place (<ulink url="http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html">http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html</ulink>). </para> - <warning> - <title> -The newbieDoc <application>lyx</application> reference - </title> - <para> -I am still writing this. - </para> - - </warning> <para> Good Luck! If you found this document useful, please let me know <email>fee...@co...</email>. </para> @@ -821,7 +790,7 @@ Bugs, errors and mistakes </title> <para> -If you find any errors, omissions etc, please let me know <email>fee...@co...</email>. +If you find any errors, omissions etc, please let me know via the newbieDoc Discussion list <email>new...@li...</email> or <email>fee...@co...</email>. </para> </sect1> @@ -831,10 +800,7 @@ Spelling, punctuation and grammar </title> <para> -I have written this document in English. I have used American spellings for some technical terms eg 'dialog', 'disk' and 'program' where these have become widely accepted. - </para> - <para> -Deciding how to use program names and package names at the beginning of a sentence is always a problem. Sentences should always begin with a capital letter, but program names and package names usually begin with a lower-case letter. I was ploughing through some man pages one day when I noticed that the program name often appeared in capital letters at the top, left-hand corner. I have taken a similar approach. In the source document I write program names and package names in lower case. I tag them so that they are rendered in a 'small caps' font in the final document. +I have written this document in English. I have used American spellings for some technical terms eg 'program' where these have become widely accepted. </para> <para> You can find guides to English spelling, punctuation and grammar at <ulink url="http://www.cral.ac.uk/guidelines/">http://www.cral.ac.uk/guidelines/</ulink>. @@ -842,12 +808,53 @@ </sect1> - <sect1> + <sect1 id="sec-Document-conventions"> <title> Conventions used in this document </title> <sect2> <title> +Ellipsis + </title> + <para> +Three dots ... + </para> + <itemizedlist> + <listitem> + <para> +if before text, indicates text has been omitted in front of the text + </para> + + </listitem> + <listitem> + <para> +if after text, indicates that following text has been omitted. + </para> + + </listitem> + <listitem> + <para> +if on one line by themselves indicates that lines have been omitted. + </para> + + </listitem> + + </itemizedlist> + + </sect2> + + <sect2> + <title> +Directory trees + </title> + <para> +A trailing forward slash (/) indicates that this is a directory, not a file. + </para> + + </sect2> + + <sect2> + <title> Command line prompts </title> <para> @@ -865,6 +872,8 @@ </para> <screen> <![CDATA[my-file.txt +]]><![CDATA[my-directory +]]><![CDATA[/my-path/my-directory/ ]]><![CDATA[]]><application><![CDATA[my-application]]></application><![CDATA[ ]]><![CDATA[]]><application><![CDATA[my-package]]></application><![CDATA[ ]]><![CDATA[This is some terminal text. @@ -888,20 +897,17 @@ Commands </title> <para> -Commands issued from a terminal look like this. Use of the <Enter> key is implied but not shown. +Commands issued from a terminal look like this. Use of the <ENTER> key is implied but not shown. </para> <screen> <![CDATA[$ ]]><command><![CDATA[my command]]></command><![CDATA[ ]]> </screen> <para> -The 3rd line in this example shows a command issued in X. +This example shows a command issued in an X application. </para> <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ ]]><command><![CDATA[Close]]></command><![CDATA[ -]]><![CDATA[ +<![CDATA[]]><emphasis><![CDATA[Menu bar: ]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[Close]]></command><![CDATA[ ]]> </synopsis> |
From: <new...@li...> - 2004-04-28 16:21:18
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/newbiedoc-lyx-reference.en Added Files: app-analysis-of-lyx-styles.html.en sec-appendix-about-document.html.en sec-document-conventions.html.en t1.html.en x223.html.en x32.html.en x40.html.en x419.html.en x428.html.en x571.html.en x618.html.en x622.html.en x626.html.en x631.html.en Log Message: added multi-page HTML version |
From: <new...@li...> - 2004-04-28 16:18:59
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/newbiedoc-lyx-reference.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/newbiedoc-lyx-reference.en added to the repository |
From: <new...@li...> - 2004-04-28 16:18:10
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/newbiedoc-lyx-quick-guide.en Added Files: a347.html.en sec-document-conventions.html.en t1.html.en x194.html.en x202.html.en x32.html.en x339.html.en x349.html.en x353.html.en x357.html.en x362.html.en Log Message: added multi-page HTML |
From: <new...@li...> - 2004-04-28 16:15:26
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/newbiedoc-lyx-quick-guide.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/newbiedoc-lyx-quick-guide.en added to the repository |
From: <new...@li...> - 2004-04-28 16:13:52
|
Newbiedoc CVS committal Author : chrislale Project : web Module : metadoc Dir : web/metadoc Modified Files: newbiedoc-lyx-quick-guide.html.en Log Message: now works with standard css stylesheet =================================================================== RCS file: /cvsroot/newbiedoc/web/metadoc/newbiedoc-lyx-quick-guide.html.en,v retrieving revision 1.3 retrieving revision 1.4 diff -u -3 -r1.3 -r1.4 --- newbiedoc-lyx-quick-guide.html.en 12 Mar 2004 16:41:43 -0000 1.3 +++ newbiedoc-lyx-quick-guide.html.en 28 Apr 2004 16:13:45 -0000 1.4 @@ -9,7 +9,30 @@ "><LINK REL="STYLESHEET" TYPE="text/css" -HREF="../peripherals/chris-nd-style.css"></HEAD +HREF="/nd-style.css"> + +<!-- Extra styles needed for LyX-generated newbieDoc html files --> +<STYLE TYPE="text/css"> +<!-- +b.COMMAND {font-style:bold;} +tt.FILENAME {font-family: monospace;} +SPAN.APPLICATION {font-variant: small-caps;} +PRE.SYNOPSIS { + background-color: #ffffcc; + border:solid; + border-color: #009999; + border-left: solid #009999 20px; + border-right: solid #009999 0px; + border-top: solid #009999 0px; + border-bottom: solid #009999 0px; + padding-left: 15pt; + font-family: sans-serif; + } +//--> +</STYLE> +<!-- End of extra styles needed for LyX-generated newbieDoc html files --> + +</HEAD ><BODY CLASS="ARTICLE" BGCOLOR="#FFFFFF" @@ -42,7 +65,7 @@ CLASS="ADDRESS" ><P CLASS="ADDRESS" -> fee...@co... +> chr...@us... <br> <br> </P @@ -123,7 +146,7 @@ > to produce newbieDoc DocBook SGML. The exported SGML can be rendered into HTML using <SPAN CLASS="APPLICATION" >sgmltools-lite</SPAN -> in the usual way. The process described in this document is known to work <SPAN +> in the usual way. The instructions in this document are known to work <SPAN CLASS="APPLICATION" >lyx</SPAN > version 1.3.3 running in Debian 3.0 (Woody). @@ -173,17 +196,17 @@ ></DT ><DT >1.4. <A -HREF="#AEN131" +HREF="#AEN133" >NewbieDoc template</A ></DT ><DT >1.5. <A -HREF="#AEN152" ->HTML style-sheet nd-style.css</A +HREF="#AEN154" +>CSS styles</A ></DT ><DT >1.6. <A -HREF="#AEN198" +HREF="#AEN180" >Making the newbieDoc styles available in <SPAN CLASS="APPLICATION" >lyx</SPAN @@ -193,12 +216,12 @@ ></DD ><DT >2. <A -HREF="#AEN210" +HREF="#AEN194" >“Hello world!” the basic SGML document</A ></DT ><DT >3. <A -HREF="#AEN218" +HREF="#AEN202" >“Hello world!” using <SPAN CLASS="APPLICATION" >lyx</SPAN @@ -208,7 +231,7 @@ ><DL ><DT >3.1. <A -HREF="#AEN221" +HREF="#AEN205" >Why use <SPAN CLASS="APPLICATION" >lyx</SPAN @@ -221,7 +244,7 @@ ></DT ><DT >3.3. <A -HREF="#AEN236" +HREF="#AEN221" ><SPAN CLASS="APPLICATION" >lyx</SPAN @@ -229,12 +252,12 @@ ></DT ><DT >3.4. <A -HREF="#AEN245" +HREF="#AEN230" >Modify the document information</A ></DT ><DT >3.5. <A -HREF="#AEN273" +HREF="#AEN258" >Add the content using <SPAN CLASS="APPLICATION" >lyx</SPAN @@ -242,12 +265,12 @@ ></DT ><DT >3.6. <A -HREF="#AEN290" +HREF="#AEN278" >Generate and view SGML code</A ></DT ><DT >3.7. <A -HREF="#AEN314" +HREF="#AEN304" >Generate and view the HTML web page</A ></DT ><DT @@ -259,39 +282,39 @@ ></DD ><DT >4. <A -HREF="#AEN344" +HREF="#AEN339" >What next?</A ></DT ><DT >A. <A -HREF="#AEN355" +HREF="#AEN347" >Appendix: About this document</A ></DT ><DD ><DL ><DT >A.1. <A -HREF="#AEN357" +HREF="#AEN349" >Copyright information</A ></DT ><DT >A.2. <A -HREF="#AEN361" +HREF="#AEN353" >Latest version</A ></DT ><DT >A.3. <A -HREF="#AEN365" +HREF="#AEN357" >Bugs, errors and mistakes</A ></DT ><DT >A.4. <A -HREF="#AEN369" +HREF="#AEN362" >Spelling, punctuation and grammar</A ></DT ><DT >A.5. <A -HREF="#AEN375" +HREF="#SEC-DOCUMENT-CONVENTIONS" >Conventions used in this document</A ></DT ></DL @@ -625,7 +648,10 @@ ><A NAME="AEN118">1.3.1. System-wide installation as user Root</H4 ><P ->Copy the files to <TT +>Installed this way, all users will be able to use these <SPAN +CLASS="APPLICATION" +>lyx</SPAN +> layouts. Copy the files to <TT CLASS="FILENAME" >/usr/share/lyx/layouts/</TT >. @@ -654,9 +680,12 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN124">1.3.2. Local installation as a normal user</H4 +NAME="AEN125">1.3.2. Local installation as a normal user</H4 ><P ->Exit from user Root first, thencopy the files to <TT +>Installed this way, only the user installing the <SPAN +CLASS="APPLICATION" +>lyx</SPAN +> layouts will have access to them. Exit from user Root first, then copy the files to <TT CLASS="FILENAME" >˜/.lyx/layouts/</TT >. @@ -690,7 +719,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN131">1.4. NewbieDoc template</H3 +NAME="AEN133">1.4. NewbieDoc template</H3 ><P >Templates can be placed either in <TT CLASS="FILENAME" @@ -717,7 +746,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN140">1.4.1. System-wide installation as user Root</H4 +NAME="AEN142">1.4.1. System-wide installation as user Root</H4 ><TABLE BORDER="0" BGCOLOR="#BBDDFF" @@ -743,7 +772,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN144">1.4.2. Local installation as a normal user</H4 +NAME="AEN146">1.4.2. Local installation as a normal user</H4 ><P >Exit from user Root if necessary </P @@ -795,156 +824,60 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN152">1.5. HTML style-sheet nd-style.css</H3 -><P ->You must be user Root to install this style sheet. - </P +NAME="AEN154">1.5. CSS styles</H3 ><P ->NewbieDoc HTML pages look for a CSS style sheet (named nd-style.css) in the root directory. The root directory is either the system's root (/), or the document directory (eg <TT -CLASS="FILENAME" ->/var/www/</TT ->) if you are viewing web pages via a web server. The HTML produced by <SPAN -CLASS="APPLICATION" ->lyx/sgmltools</SPAN -> needs an enhanced version of the newbieDoc CSS style sheet (<TT +>NewbieDoc HTML pages look for a CSS style sheet (named <TT CLASS="FILENAME" >nd-style.css</TT ->). +>) in the root directory. The root directory is either the system's root (/), or the document directory (eg <TT +CLASS="FILENAME" +>/var/www/</TT +>) if you are viewing web pages via a web server. </P -><DIV -CLASS="SECT3" -><HR><H4 -CLASS="SECT3" -><A -NAME="AEN159">1.5.1. Quick and dirty solution</H4 ><P ->If you are in a hurry, just copy <TT -CLASS="FILENAME" ->html-css-stylesheet/nd-style.css</TT -> to your system's root. (You must be user Root to do this.) +>The newbieDoc Lyx styles use some extra CSS styles not available in the current version of nd-style.css. The extra styles are + </P +><P +></P +><UL +><LI +><P +>command (bold) </P +></LI +><LI ><P ->First move any existing version out of the way. This is preferable to deleting it! +>filename (monospace) </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" -># <B -CLASS="COMMAND" ->mv</B -> /nd-style.css /nd-style.css.orig - </PRE -></TD -></TR -></TABLE +></LI +><LI ><P ->Now copy the replacement style sheet to root. +>application (smallcaps) </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" -># <B -CLASS="COMMAND" ->cp</B -> newbiedoc-lyx-files_n.nn/html-css-stylesheet/nd-style.css / - </PRE -></TD -></TR -></TABLE -></DIV +></LI +><LI +><P +>xscreen (similar to screen but with sans-serif font) + </P +></LI +></UL +><P +>If you want to use these extra styles, you must hard-code them into your final HTML files. + </P ><DIV CLASS="SECT3" ><HR><H4 CLASS="SECT3" ><A -NAME="AEN169">1.5.2. A more elegant solution</H4 +NAME="AEN170">1.5.1. Hard-coding the extra styles into the final HTML file</H4 ><P ->This method uses <SPAN -CLASS="APPLICATION" ->update-alternatives</SPAN ->. It enables you to have more than one file with the same name. This is especially useful if you wish to keep an existing version of nd-style.css. - </P -><P ->Move any existing version out of the way and copy the replacement style sheet to root with its name changed to <TT +>Open the HTML file in a text editor and find <TT CLASS="FILENAME" ->nd-style.css.lyx</TT ->. +><LINK REL="STYLESHEET" TYPE="text/css" HREF="/nd-style.css"></TT +>. Insert the text below immediately after it. </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" -># <B -CLASS="COMMAND" ->mv</B ->/nd-style.css /nd-style.css.orig -# <B -CLASS="COMMAND" ->cp</B ->html-css-stylesheet/nd-style.css /nd-style.css.lyx - </PRE -></TD -></TR -></TABLE -><P ->Install <TT -CLASS="FILENAME" ->nd-style.css.lyx</TT -> as the first alternative to <TT -CLASS="FILENAME" ->nd-style.css</TT ->. Create a link (<TT -CLASS="FILENAME" ->nd-style.css</TT ->) in <TT -CLASS="FILENAME" ->/etc/alternatives</TT -> which points to <TT -CLASS="FILENAME" ->/nd-style.css.lyx</TT -> with priority 6. - </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" -># <B -CLASS="COMMAND" ->update-alternatives</B -> --verbose --install \ -/nd-style.css nd-style.css /nd-style.css.lyx 6 - </PRE -></TD -></TR -></TABLE ><P ->Check the link +>This is the code immediately before the inserted text. </P ><TABLE BORDER="0" @@ -956,28 +889,16 @@ ><TD ><PRE CLASS="SCREEN" -># <B -CLASS="COMMAND" ->update-alternatives</B -> --verbose --display \ -nd-style.css - -... - - -Current `best' version is /nd-style.css.lyx +> "><LINK +REL="STYLESHEET" +TYPE="text/css" +HREF="/nd-style.css"> </PRE ></TD ></TR ></TABLE ><P ->Install <TT -CLASS="FILENAME" ->nd-style.css.orig</TT -> as the second alternative to <TT -CLASS="FILENAME" ->nd-style.css</TT ->. Create a link to the second alternative with a priority less than 6. +>Insert this extra HTML code. </P ><TABLE BORDER="0" @@ -989,17 +910,32 @@ ><TD ><PRE CLASS="SCREEN" -># <B -CLASS="COMMAND" ->update-alternatives</B -> --verbose --install \ -/nd-style.css nd-style.css /nd-style.css.orig 4 +><!-- Extra styles needed for LyX-generated newbieDoc html files --> +<STYLE TYPE="text/css"> +<!-- +b.COMMAND {font-style:bold;} +tt.FILENAME {font-family: monospace;} +SPAN.APPLICATION {font-variant: small-caps;} +PRE.SYNOPSIS { + background-color: #ffffcc; + border:solid; + border-color: #009999; + border-left: solid #009999 20px; + border-right: solid #009999 0px; + border-top: solid #009999 0px; + border-bottom: solid #009999 0px; + padding-left: 15pt; + font-family: sans-serif; + } +//--> +</STYLE> +<!-- End of extra styles needed for LyX-generated newbieDoc html files --> </PRE ></TD ></TR ></TABLE ><P ->Check the alternatives are configured correctly. The current default version is tagged with a '*'. +>This is the code immediately after the inserted text. </P ><TABLE BORDER="0" @@ -1011,23 +947,8 @@ ><TD ><PRE CLASS="SCREEN" -># <B -CLASS="COMMAND" ->update-alternatives</B -> --verbose --config \ -/nd-style.css - -There are 2 programs which provide `/nd-style.css'. - Selection Command ------------------------------------------------ -*+ 1 /nd-style.css.lyx - 2 /nd-style.css.orig - -Enter to keep the default[*], or type selection number: <B -CLASS="COMMAND" ->1</B -> -# +></HEAD +><BODY </PRE ></TD ></TR @@ -1039,7 +960,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN198">1.6. Making the newbieDoc styles available in <SPAN +NAME="AEN180">1.6. Making the newbieDoc styles available in <SPAN CLASS="APPLICATION" >lyx</SPAN ></H3 @@ -1069,11 +990,12 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar: </I ></SPAN -> - Edit - <B +> <B +CLASS="COMMAND" +>Edit</B +> -> <B CLASS="COMMAND" >Reconfigure</B > @@ -1082,11 +1004,12 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar:</I ></SPAN -> - File - <B +> <B +CLASS="COMMAND" +>File</B +> -><B CLASS="COMMAND" >Exit</B > @@ -1101,7 +1024,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN210">2. “Hello world!” the basic SGML document</H2 +NAME="AEN194">2. “Hello world!” the basic SGML document</H2 ><P >Here is a very basic SGML document taken from the newbieDoc DocBook guide (<A HREF="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html" @@ -1147,7 +1070,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN218">3. “Hello world!” using <SPAN +NAME="AEN202">3. “Hello world!” using <SPAN CLASS="APPLICATION" >lyx</SPAN ></H2 @@ -1156,7 +1079,7 @@ ><H3 CLASS="SECT2" ><A -NAME="AEN221">3.1. Why use <SPAN +NAME="AEN205">3.1. Why use <SPAN CLASS="APPLICATION" >lyx</SPAN > to produce SGML?</H3 @@ -1184,7 +1107,7 @@ >Open a new document from <SPAN CLASS="APPLICATION" >lyx</SPAN ->'s menu bar: +>'s menu bar. </P ><TABLE BORDER="0" @@ -1200,16 +1123,15 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar:</I ></SPAN -> - File - <B +> <B +CLASS="COMMAND" +>File</B +> -> <B CLASS="COMMAND" >New from Template</B -> - newbiedoc-lyx-template.lyx - <B +> -> newbiedoc-lyx-template.lyx -> <B CLASS="COMMAND" >OK </B > @@ -1223,7 +1145,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN236">3.3. <SPAN +NAME="AEN221">3.3. <SPAN CLASS="APPLICATION" >lyx</SPAN > layouts and the list of styles</H3 @@ -1251,7 +1173,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN245">3.4. Modify the document information</H3 +NAME="AEN230">3.4. Modify the document information</H3 ><P >Substitute your own information in the template's place-holders: </P @@ -1326,7 +1248,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN273">3.5. Add the content using <SPAN +NAME="AEN258">3.5. Add the content using <SPAN CLASS="APPLICATION" >lyx</SPAN > styles</H3 @@ -1334,7 +1256,7 @@ >This is how to produce a simple article with only one section and one paragraph of standard text. Position the insertion point (flashing vertical bar) at the end of the document. Create a new line by pressing the <ENTER> key. </P ><P ->Select 'Section' from the list of styles. Enter the title 'Hello world message' (without the quotes) and press the <ENTER> key: +>Select 'Section' from the list of styles. The drop-down styles list is the left-most button in the button bar. Enter the title 'Hello world message' (without the quotes) and press the <ENTER> key. </P ><TABLE BORDER="0" @@ -1352,13 +1274,18 @@ CLASS="EMPHASIS" >Drop-down styles list</I ></SPAN -> - <B +>: <B CLASS="COMMAND" >Section</B > - Hello world message +<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>LyX main window:</I +></SPAN +> Hello world message </PRE ></TD ></TR @@ -1380,15 +1307,20 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Drop-down styles list</I +>Drop-down styles list:</I ></SPAN -> - <B +> <B CLASS="COMMAND" >Standard</B > - Hello world! +<SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>LyX main window: </I +></SPAN +> Hello world! </PRE ></TD ></TR @@ -1410,16 +1342,15 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar:</I ></SPAN -> - File - <B +> <B +CLASS="COMMAND" +>File</B +> -> <B CLASS="COMMAND" >Save</B -> - hello-world.en - <B +> -> hello-world.en -> <B CLASS="COMMAND" >Save</B > @@ -1433,7 +1364,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN290">3.6. Generate and view SGML code</H3 +NAME="AEN278">3.6. Generate and view SGML code</H3 ><P >Generate DocBook SGML using <SPAN CLASS="APPLICATION" @@ -1454,12 +1385,15 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar:</I ></SPAN -> - File - Export - <B +> <B +CLASS="COMMAND" +>File</B +> -> <B +CLASS="COMMAND" +>Export</B +> -> <B CLASS="COMMAND" >DocBook</B > @@ -1569,7 +1503,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN314">3.7. Generate and view the HTML web page</H3 +NAME="AEN304">3.7. Generate and view the HTML web page</H3 ><P >You can transform your <TT CLASS="FILENAME" @@ -1638,8 +1572,17 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Web page:</I +>Web browser</I ></SPAN +>: <B +CLASS="COMMAND" +>File</B +> -> <B +CLASS="COMMAND" +>Open</B +> -> hello-world.en.html -> <B +CLASS="COMMAND" +>OK</B > <B @@ -1699,8 +1642,14 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Web page:</I +>Web browser:</I ></SPAN +> <B +CLASS="COMMAND" +>View</B +> -> <B +CLASS="COMMAND" +>Reload</B > Table of Contents @@ -1724,7 +1673,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN344">4. What next?</H2 +NAME="AEN339">4. What next?</H2 ><P >You should now be able to produce a basic newbieDoc article quickly and easily. I expect that you will soon want to use other layouts and some in-line elements in your documents. (<SPAN CLASS="APPLICATION" @@ -1732,48 +1681,12 @@ > handles some inline elements well eg URL links, tables and graphics. It is not so good with filename, command or application.) The newbieDoc <SPAN CLASS="APPLICATION" >lyx</SPAN -> reference might be a good starting place. - </P -><DIV -CLASS="WARNING" -><P -></P -><TABLE -CLASS="WARNING" -WIDTH="100%" -BORDER="0" -><TR -><TD -WIDTH="25" -ALIGN="CENTER" -VALIGN="TOP" -><IMG -SRC="../images/warning.gif" -HSPACE="5" -ALT="Warning"></TD -><TH -ALIGN="LEFT" -VALIGN="CENTER" -><B ->The newbieDoc <SPAN -CLASS="APPLICATION" ->lyx</SPAN -> reference</B -></TH -></TR -><TR -><TD -> </TD -><TD -ALIGN="LEFT" -VALIGN="TOP" -><P ->I am still writing this. +> reference might be a good starting place (<A +HREF="http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html" +TARGET="_top" +>http://newbiedoc.sourceforge.net/web/newbiedoc-lyx-reference.en.html</A +>). </P -></TD -></TR -></TABLE -></DIV ><P >Good Luck! If you found this document useful, please let me know <TT CLASS="EMAIL" @@ -1789,13 +1702,13 @@ ><HR><H1 CLASS="APPENDIX" ><A -NAME="AEN355">A. Appendix: About this document</H1 +NAME="AEN347">A. Appendix: About this document</H1 ><DIV CLASS="SECT1" ><H2 CLASS="SECT1" ><A -NAME="AEN357">A.1. Copyright information</H2 +NAME="AEN349">A.1. Copyright information</H2 ><P >Copyright ©2004 Chris Lale <TT CLASS="EMAIL" @@ -1811,7 +1724,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN361">A.2. Latest version</H2 +NAME="AEN353">A.2. Latest version</H2 ><P >You can get the latest version of this document from <A HREF="http://newbiedoc.sourceforge.net" @@ -1825,9 +1738,15 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN365">A.3. Bugs, errors and mistakes</H2 +NAME="AEN357">A.3. Bugs, errors and mistakes</H2 ><P ->If you find any errors, omissions etc, please let me know <TT +>If you find any errors, omissions etc, please let me know via the newbieDoc Discussion list <TT +CLASS="EMAIL" +><<A +HREF="mailto:new...@li..." +>new...@li...</A +>></TT +> or <TT CLASS="EMAIL" ><<A HREF="mailto:fee...@co..." @@ -1841,12 +1760,9 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN369">A.4. Spelling, punctuation and grammar</H2 +NAME="AEN362">A.4. Spelling, punctuation and grammar</H2 ><P ->I have written this document in English. I have used American spellings for some technical terms eg 'dialog', 'disk' and 'program' where these have become widely accepted. - </P -><P ->Deciding how to use program names and package names at the beginning of a sentence is always a problem. Sentences should always begin with a capital letter, but program names and package names usually begin with a lower-case letter. I was ploughing through some man pages one day when I noticed that the program name often appeared in capital letters at the top, left-hand corner. I have taken a similar approach. In the source document I write program names and package names in lower case. I tag them so that they are rendered in a 'small caps' font in the final document. +>I have written this document in English. I have used American spellings for some technical terms eg 'program' where these have become widely accepted. </P ><P >You can find guides to English spelling, punctuation and grammar at <A @@ -1861,13 +1777,52 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN375">A.5. Conventions used in this document</H2 +NAME="SEC-DOCUMENT-CONVENTIONS">A.5. Conventions used in this document</H2 ><DIV CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN377">A.5.1. Command line prompts</H3 +NAME="AEN369">A.5.1. Ellipsis</H3 +><P +>Three dots ... + </P +><P +></P +><UL +><LI +><P +>if before text, indicates text has been omitted in front of the text + </P +></LI +><LI +><P +>if after text, indicates that following text has been omitted. + </P +></LI +><LI +><P +>if on one line by themselves indicates that lines have been omitted. + </P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN379">A.5.2. Directory trees</H3 +><P +>A trailing forward slash (/) indicates that this is a directory, not a file. + </P +></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN382">A.5.3. Command line prompts</H3 ><P >A '<TT CLASS="FILENAME" @@ -1883,7 +1838,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN382">A.5.2. File names, application names, package names and screen text</H3 +NAME="AEN387">A.5.4. File names, application names, package names and screen text</H3 ><P >Filenames, application names, package names and text displayed by a console or terminal window look like this. </P @@ -1898,6 +1853,8 @@ ><PRE CLASS="SCREEN" >my-file.txt +my-directory +/my-path/my-directory/ <SPAN CLASS="APPLICATION" >my-application</SPAN @@ -1944,9 +1901,9 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN392">A.5.3. Commands</H3 +NAME="AEN397">A.5.5. Commands</H3 ><P ->Commands issued from a terminal look like this. Use of the <Enter> key is implied but not shown. +>Commands issued from a terminal look like this. Use of the <ENTER> key is implied but not shown. </P ><TABLE BORDER="0" @@ -1967,7 +1924,7 @@ ></TR ></TABLE ><P ->The 3rd line in this example shows a command issued in X. +>This example shows a command issued in an X application. </P ><TABLE BORDER="0" @@ -1983,11 +1940,12 @@ CLASS="emphasis" ><I CLASS="EMPHASIS" ->Menu bar</I +>Menu bar: </I ></SPAN -> - File - <B +> <B +CLASS="COMMAND" +>File</B +> -> <B CLASS="COMMAND" >Close</B > @@ -2001,4 +1959,4 @@ ></DIV ></BODY ></HTML -> +> \ No newline at end of file |
From: <new...@li...> - 2004-04-28 16:12:08
|
Newbiedoc CVS committal Author : chrislale Project : web Module : metadoc Dir : web/metadoc Added Files: newbiedoc-lyx-reference.html.en Log Message: new article |
From: <new...@li...> - 2004-04-28 13:30:38
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/printer-cups.en Added Files: app-about-installing-debian.html.en app-kernel-printer-support.html.en app-more-detail-for-browsers.html.en sec-document-conventions.html.en sec-linux-kernel-support.html.en t1.html.en x143.html.en x254.html.en x297.html.en x327.html.en x353.html.en x37.html.en x381.html.en x437.html.en x567.html.en x571.html.en x575.html.en x580.html.en Log Message: Added the multi-page HTML files |
From: <new...@li...> - 2004-04-28 13:27:22
|
Newbiedoc CVS committal Author : chrislale Project : web Module : tutorials Dir : web/tutorials/printer-cups.en Log Message: Directory /cvsroot/newbiedoc/web/tutorials/printer-cups.en added to the repository |
From: <new...@li...> - 2004-04-28 13:13:31
|
Newbiedoc CVS committal Author : chrislale Project : web Module : peripherals Dir : web/peripherals Modified Files: printer-cups.html.en Log Message: Now run using standard nd-style.css =================================================================== RCS file: /cvsroot/newbiedoc/web/peripherals/printer-cups.html.en,v retrieving revision 1.1 retrieving revision 1.2 diff -u -3 -r1.1 -r1.2 --- printer-cups.html.en 22 Feb 2004 10:58:57 -0000 1.1 +++ printer-cups.html.en 28 Apr 2004 13:13:20 -0000 1.2 @@ -6,10 +6,66 @@ ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ -"><LINK +"><META +NAME="KEYWORD" +CONTENT="Debian + "><META +NAME="KEYWORD" +CONTENT="GNU + "><META +NAME="KEYWORD" +CONTENT="Linux + "><META +NAME="KEYWORD" +CONTENT="print + "><META +NAME="KEYWORD" +CONTENT="printer + "><META +NAME="KEYWORD" +CONTENT="CUPS + "><META +NAME="KEYWORD" +CONTENT="newbie + "><META +NAME="KEYWORD" +CONTENT="configure + "><META +NAME="KEYWORD" +CONTENT="setup + "><META +NAME="KEYWORD" +CONTENT="install + "><META +NAME="KEYWORD" +CONTENT="HOWTO + "><LINK REL="STYLESHEET" TYPE="text/css" -HREF="chris-nd-style.css"></HEAD +HREF="/nd-style.css"> + +<!-- Extra styles needed for LyX-generated newbieDoc html files --> +<STYLE TYPE="text/css"> +<!-- +b.COMMAND {font-style:bold;} +tt.FILENAME {font-family: monospace;} +SPAN.APPLICATION {font-variant: small-caps;} +PRE.SYNOPSIS { + background-color: #ffffcc; + border:solid; + border-color: #009999; + border-left: solid #009999 20px; + border-right: solid #009999 0px; + border-top: solid #009999 0px; + border-bottom: solid #009999 0px; + padding-left: 15pt; + font-family: sans-serif; + } +//--> +</STYLE> +<!-- End of extra styles needed for LyX-generated newbieDoc html files --> + +</HEAD ><BODY CLASS="ARTICLE" BGCOLOR="#FFFFFF" @@ -39,7 +95,7 @@ CLASS="ADDRESS" ><P CLASS="ADDRESS" -> new...@co... +> chr...@us... <br> <br> </P @@ -62,22 +118,39 @@ ><TR ><TD ALIGN="LEFT" +>Revision 0.02</TD +><TD +ALIGN="LEFT" +>28 April 2004</TD +><TD +ALIGN="LEFT" +>Revised by: cl</TD +></TR +><TR +><TD +ALIGN="LEFT" +COLSPAN="3" +>Added meta keywords. Moved 'About this document' to an appendix.</TD +></TR +><TR +><TD +ALIGN="LEFT" >Revision 0.01</TD ><TD ALIGN="LEFT" >6th February 2004</TD ><TD ALIGN="LEFT" ->Revised by: CL</TD +>Revised by: cl</TD ></TR ><TR ><TD ALIGN="LEFT" COLSPAN="3" >First release. Developed and tested using Debian GNU/Linux 3.0 (Woody) and the Debian package CUPS version 1.1.14-3. This document was composed using LyX qt version 1.3.3, exported to sgml and rendered to HTML using the newbieDoc style sheets and tools available from <A -HREF="http://newbiedoc.sourceforge.net" +HREF="http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz" TARGET="_top" ->http://newbiedoc.sourceforge.net</A +>http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz</A >.</TD ></TR ></TABLE @@ -86,7 +159,7 @@ ><DIV CLASS="ABSTRACT" ><A -NAME="AEN18"><P +NAME="AEN35"><P ></P ><P >This document describes how to install and configure a printer using CUPS (the Common UNIX Printing System). The setup described in this document is known to work with Debian GNU/Linux 3.0 (Woody) and CUPS version 1.1.14-3. @@ -105,48 +178,14 @@ ></DT ><DT >1. <A -HREF="#AEN20" ->About this document</A +HREF="#AEN37" +>Introduction</A ></DT ><DD ><DL ><DT >1.1. <A -HREF="#AEN22" ->Copyright information</A -></DT -><DT ->1.2. <A -HREF="#AEN26" ->Latest version</A -></DT -><DT ->1.3. <A -HREF="#AEN30" ->Bugs, errors and mistakes</A -></DT -><DT ->1.4. <A -HREF="#AEN33" ->Spelling, punctuation and grammar</A -></DT -><DT ->1.5. <A HREF="#AEN39" ->Conventions used in this document</A -></DT -></DL -></DD -><DT ->2. <A -HREF="#AEN65" ->Introduction</A -></DT -><DD -><DL -><DT ->2.1. <A -HREF="#AEN67" >About <SPAN CLASS="APPLICATION" >lpr</SPAN @@ -156,42 +195,42 @@ ></A ></DT ><DT ->2.2. <A -HREF="#AEN86" +>1.2. <A +HREF="#AEN58" >About <SPAN CLASS="APPLICATION" >cups</SPAN ></A ></DT ><DT ->2.3. <A -HREF="#AEN113" +>1.3. <A +HREF="#AEN85" >Outline of the installation</A ></DT ></DL ></DD ><DT ->3. <A +>2. <A HREF="#SEC-LINUX-KERNEL-SUPPORT" >Linux kernel support for printer port</A ></DT ><DD ><DL ><DT ->3.1. <A -HREF="#AEN151" +>2.1. <A +HREF="#AEN123" >Check parallel port</A ></DT ><DT ->3.2. <A -HREF="#AEN160" +>2.2. <A +HREF="#AEN132" >Check USB port</A ></DT ></DL ></DD ><DT ->4. <A -HREF="#AEN171" +>3. <A +HREF="#AEN143" >Install <SPAN CLASS="APPLICATION" >cups</SPAN @@ -200,7 +239,7 @@ ><DD ><DL ><DT ->4.1. <A +>3.1. <A HREF="#SEC-INSTALL-CUPSYS-PACKAGES" >Install <SPAN CLASS="APPLICATION" @@ -208,15 +247,15 @@ > and related packages</A ></DT ><DT ->4.2. <A -HREF="#AEN227" +>3.2. <A +HREF="#AEN199" >Install and configure the <SPAN CLASS="APPLICATION" >foomatic</SPAN > database (optional)</A ></DT ><DT ->4.3. <A +>3.3. <A HREF="#SEC-INSTALL-A-PPD" >Install a <TT CLASS="FILENAME" @@ -226,8 +265,8 @@ ></DL ></DD ><DT ->5. <A -HREF="#AEN282" +>4. <A +HREF="#AEN254" >Install a printer using <SPAN CLASS="APPLICATION" >cups</SPAN @@ -236,23 +275,23 @@ ><DD ><DL ><DT ->5.1. <A -HREF="#AEN285" +>4.1. <A +HREF="#AEN257" >Log into <SPAN CLASS="APPLICATION" >cups</SPAN > using a web browser</A ></DT ><DT ->5.2. <A -HREF="#AEN296" +>4.2. <A +HREF="#AEN268" >Install the printer</A ></DT ></DL ></DD ><DT ->6. <A -HREF="#AEN325" +>5. <A +HREF="#AEN297" >Configure the printer using <SPAN CLASS="APPLICATION" >cups</SPAN @@ -261,13 +300,13 @@ ><DD ><DL ><DT ->6.1. <A +>5.1. <A HREF="#SEC-SET-DEFAULT-OPTIONS" >Set default options for your printer</A ></DT ><DT ->6.2. <A -HREF="#AEN340" +>5.2. <A +HREF="#AEN312" >Test your printer from <SPAN CLASS="APPLICATION" >cups</SPAN @@ -276,8 +315,8 @@ ></DL ></DD ><DT ->7. <A -HREF="#AEN355" +>6. <A +HREF="#AEN327" >Install an alternative front end for managing <SPAN CLASS="APPLICATION" >cups</SPAN @@ -292,7 +331,7 @@ ><DL ><DT >A.1. <A -HREF="#AEN381" +HREF="#AEN353" >About installing Debian packages</A ></DT ></DL @@ -306,7 +345,7 @@ ><DL ><DT >B.1. <A -HREF="#AEN409" +HREF="#AEN381" >Managing printers using various browsers</A ></DT ></DL @@ -320,9 +359,34 @@ ><DL ><DT >C.1. <A -HREF="#AEN465" +HREF="#AEN437" >Kernel printer port support</A ></DT +><DT +>C.2. <A +HREF="#AEN567" +>Copyright information</A +></DT +><DT +>C.3. <A +HREF="#AEN571" +>Latest version</A +></DT +><DT +>C.4. <A +HREF="#AEN575" +>Bugs, errors and mistakes</A +></DT +><DT +>C.5. <A +HREF="#AEN580" +>Spelling, punctuation and grammar</A +></DT +><DT +>C.6. <A +HREF="#SEC-DOCUMENT-CONVENTIONS" +>Conventions used in this document</A +></DT ></DL ></DD ></DL @@ -332,219 +396,13 @@ ><H2 CLASS="SECT1" ><A -NAME="AEN20">1. About this document</H2 -><DIV -CLASS="SECT2" -><H3 -CLASS="SECT2" -><A -NAME="AEN22">1.1. Copyright information</H3 -><P ->Copyright ©2004 Chris Lale (<A -HREF="mailto:new...@co..." -TARGET="_top" ->new...@co...</A ->). Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. - </P -></DIV -><DIV -CLASS="SECT2" -><HR><H3 -CLASS="SECT2" -><A -NAME="AEN26">1.2. Latest version</H3 -><P ->You can get the latest version of this document from <A -HREF="http://newbiedoc.sourceforge.net" -TARGET="_top" ->http://newbiedoc.sourceforge.net</A ->. - </P -></DIV -><DIV -CLASS="SECT2" -><HR><H3 -CLASS="SECT2" -><A -NAME="AEN30">1.3. Bugs, errors and mistakes</H3 -><P ->If you find any errors, omissions etc, please let me know. My email address is at the top of this document. - </P -></DIV -><DIV -CLASS="SECT2" -><HR><H3 -CLASS="SECT2" -><A -NAME="AEN33">1.4. Spelling, punctuation and grammar</H3 -><P ->I have written this document in English. I have used American spellings for some technical terms eg 'dialog', 'disk' and 'program' where these have become widely accepted. - </P -><P ->Deciding how to use program names and package names at the beginning of a sentance is always a problem. Sentences should always begin with a capital letter, but program names and package names usually begin with a lower-case letter. I was ploughing through some man pages one day when I noticed that the program name often appeared in capital letters at the top, left-hand corner. I have taken a similar approach. In the source document I write program names and package names in lower case. I tag them so that they are rendered in a 'small caps' font in the final document. - </P -><P ->You can find guides to English spelling, punctuation and grammar at <A -HREF="http://www.cral.ac.uk/guidelines/" -TARGET="_top" ->http://www.cral.ac.uk/guidelines/</A ->. - </P -></DIV -><DIV -CLASS="SECT2" -><HR><H3 -CLASS="SECT2" -><A -NAME="AEN39">1.5. Conventions used in this document</H3 -><DIV -CLASS="SECT3" -><H4 -CLASS="SECT3" -><A -NAME="AEN41">1.5.1. Command line prompts</H4 -><P ->A <TT -CLASS="FILENAME" ->$</TT -> at the start of a line indicates that the rest of the line is input from a normal user. A <TT -CLASS="FILENAME" ->#</TT -> indicates that the Root user inputs the rest of the line. - </P -></DIV -><DIV -CLASS="SECT3" -><HR><H4 -CLASS="SECT3" -><A -NAME="AEN46">1.5.2. File names, application names, package names and screen text</H4 -><P ->Filenames, application names, package names and text displayed by a console or terminal window look like this. - </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" ->my-file.txt -<SPAN -CLASS="APPLICATION" ->my-application</SPAN -> -<SPAN -CLASS="APPLICATION" ->my-package</SPAN -> -This is some terminal text. - </PRE -></TD -></TR -></TABLE -><P ->Filenames, application names, package names and text displayed in an X window look like this. - </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SYNOPSIS" ->my-file.txt -<SPAN -CLASS="APPLICATION" ->my-application</SPAN -> -<SPAN -CLASS="APPLICATION" ->my-package</SPAN -> -This is some text in an X window. - </PRE -></TD -></TR -></TABLE -></DIV -><DIV -CLASS="SECT3" -><HR><H4 -CLASS="SECT3" -><A -NAME="AEN56">1.5.3. Commands</H4 -><P ->Commands issued from a terminal look like this. Use of the <Enter> key is implied but not shown. - </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SCREEN" ->$ <B -CLASS="COMMAND" ->my command</B -> - </PRE -></TD -></TR -></TABLE -><P ->The 3rd line in this example shows a command issued in X. - </P -><TABLE -BORDER="0" -BGCOLOR="#BBDDFF" -WIDTH="100%" -CELLPADDING="0" -CELLSPACING="0" -><TR -><TD -><PRE -CLASS="SYNOPSIS" -><SPAN -CLASS="emphasis" -><I -CLASS="EMPHASIS" ->Menu bar</I -></SPAN -> - File - <B -CLASS="COMMAND" ->Close</B -> - </PRE -></TD -></TR -></TABLE -></DIV -></DIV -></DIV -><DIV -CLASS="SECT1" -><HR><H2 -CLASS="SECT1" -><A -NAME="AEN65">2. Introduction</H2 +NAME="AEN37">1. Introduction</H2 ><DIV CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN67">2.1. About <SPAN +NAME="AEN39">1.1. About <SPAN CLASS="APPLICATION" >lpr</SPAN > and <SPAN @@ -603,7 +461,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN86">2.2. About <SPAN +NAME="AEN58">1.2. About <SPAN CLASS="APPLICATION" >cups</SPAN ></H3 @@ -687,7 +545,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN113">2.3. Outline of the installation</H3 +NAME="AEN85">1.3. Outline of the installation</H3 ><DIV CLASS="NOTE" ><P @@ -857,7 +715,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="SEC-LINUX-KERNEL-SUPPORT">3. Linux kernel support for printer port</H2 +NAME="SEC-LINUX-KERNEL-SUPPORT">2. Linux kernel support for printer port</H2 ><P >You may already have printer port support in your kernel. If not, you must install the necessary kernel modules (see the appendix on <A HREF="#APP-KERNEL-PRINTER-SUPPORT" @@ -878,7 +736,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN151">3.1. Check parallel port</H3 +NAME="AEN123">2.1. Check parallel port</H3 ><P >If you have a standard PC with a parallel port, the output should look something like this: </P @@ -923,7 +781,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN160">3.2. Check USB port</H3 +NAME="AEN132">2.2. Check USB port</H3 ><DIV CLASS="WARNING" ><P @@ -945,7 +803,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Warning: This section is untested</B +>This section is untested</B ></TH ></TR ><TR @@ -958,8 +816,8 @@ >I do not have a USB printer, so this is my 'best guess' at how to install one. If you get a USB printer working please let me know (<TT CLASS="EMAIL" ><<A -HREF="mailto:new...@co..." ->new...@co...</A +HREF="mailto:fee...@co..." +>fee...@co...</A >></TT >) and I will update this document. </P @@ -1001,7 +859,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN171">4. Install <SPAN +NAME="AEN143">3. Install <SPAN CLASS="APPLICATION" >cups</SPAN ></H2 @@ -1026,7 +884,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Warning: <SPAN +><SPAN CLASS="APPLICATION" >lpr</SPAN > or <SPAN @@ -1068,7 +926,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="SEC-INSTALL-CUPSYS-PACKAGES">4.1. Install <SPAN +NAME="SEC-INSTALL-CUPSYS-PACKAGES">3.1. Install <SPAN CLASS="APPLICATION" >cupsys</SPAN > and related packages</H3 @@ -1208,7 +1066,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN227">4.2. Install and configure the <SPAN +NAME="AEN199">3.2. Install and configure the <SPAN CLASS="APPLICATION" >foomatic</SPAN > database (optional)</H3 @@ -1233,7 +1091,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: The <SPAN +>The <SPAN CLASS="APPLICATION" >foomatic</SPAN > database provides many<TT @@ -1324,7 +1182,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: Ncurses navigation</B +>Ncurses navigation</B ></TH ></TR ><TR @@ -1406,7 +1264,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="SEC-INSTALL-A-PPD">4.3. Install a <TT +NAME="SEC-INSTALL-A-PPD">3.3. Install a <TT CLASS="FILENAME" >.ppd</TT > file (optional)</H3 @@ -1431,7 +1289,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: Install a <TT +>Install a <TT CLASS="FILENAME" >.ppd</TT > driver not provided by the <SPAN @@ -1534,7 +1392,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN282">5. Install a printer using <SPAN +NAME="AEN254">4. Install a printer using <SPAN CLASS="APPLICATION" >cups</SPAN ></H2 @@ -1543,7 +1401,7 @@ ><H3 CLASS="SECT2" ><A -NAME="AEN285">5.1. Log into <SPAN +NAME="AEN257">4.1. Log into <SPAN CLASS="APPLICATION" >cups</SPAN > using a web browser</H3 @@ -1568,7 +1426,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: Browser variations</B +>Browser variations</B ></TH ></TR ><TR @@ -1620,7 +1478,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN296">5.2. Install the printer</H3 +NAME="AEN268">4.2. Install the printer</H3 ><P >Navigate to the Printers menu in the Admin main menu page. Choose to add a printer. </P @@ -1773,7 +1631,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN325">6. Configure the printer using <SPAN +NAME="AEN297">5. Configure the printer using <SPAN CLASS="APPLICATION" >cups</SPAN ></H2 @@ -1782,7 +1640,7 @@ ><H3 CLASS="SECT2" ><A -NAME="SEC-SET-DEFAULT-OPTIONS">6.1. Set default options for your printer</H3 +NAME="SEC-SET-DEFAULT-OPTIONS">5.1. Set default options for your printer</H3 ><P >Navigate to Admin main menu page. Find your printer's menu in the Printer menu page. Choose Configure Printer. </P @@ -1862,7 +1720,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN340">6.2. Test your printer from <SPAN +NAME="AEN312">5.2. Test your printer from <SPAN CLASS="APPLICATION" >cups</SPAN ></H3 @@ -1946,7 +1804,7 @@ ><HR><H2 CLASS="SECT1" ><A -NAME="AEN355">7. Install an alternative front end for managing <SPAN +NAME="AEN327">6. Install an alternative front end for managing <SPAN CLASS="APPLICATION" >cups</SPAN > (optional)</H2 @@ -2042,13 +1900,13 @@ ><H2 CLASS="SECT1" ><A -NAME="AEN381">A.1. About installing Debian packages</H2 +NAME="AEN353">A.1. About installing Debian packages</H2 ><DIV CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN383">A.1.1. Log in as a normal user</H3 +NAME="AEN355">A.1.1. Log in as a normal user</H3 ><P >You should login as a normal user rather than as the superuser (user Root). </P @@ -2058,7 +1916,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN386">A.1.2. Switch to user Root only when needed</H3 +NAME="AEN358">A.1.2. Switch to user Root only when needed</H3 ><P >If necessary, you can switch user to Root from a normal user's account. using the switch user (<B CLASS="COMMAND" @@ -2074,7 +1932,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN391">A.1.3. Install or remove Debian packages</H3 +NAME="AEN363">A.1.3. Install or remove Debian packages</H3 ><P >There are several applications that install Debian packages. <SPAN CLASS="APPLICATION" @@ -2154,13 +2012,13 @@ ><H2 CLASS="SECT1" ><A -NAME="AEN409">B.1. Managing printers using various browsers</H2 +NAME="AEN381">B.1. Managing printers using various browsers</H2 ><DIV CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN411">B.1.1. <SPAN +NAME="AEN383">B.1.1. <SPAN CLASS="APPLICATION" >mozilla</SPAN ></H3 @@ -2206,7 +2064,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN420">B.1.2. <SPAN +NAME="AEN392">B.1.2. <SPAN CLASS="APPLICATION" >galeon</SPAN ></H3 @@ -2253,7 +2111,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN429">B.1.3. <SPAN +NAME="AEN401">B.1.3. <SPAN CLASS="APPLICATION" >konqueror</SPAN ></H3 @@ -2314,7 +2172,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN441">B.1.4. <SPAN +NAME="AEN413">B.1.4. <SPAN CLASS="APPLICATION" >lynx</SPAN ></H3 @@ -2366,7 +2224,7 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN453">B.1.5. Elinks (<SPAN +NAME="AEN425">B.1.5. Elinks (<SPAN CLASS="APPLICATION" >links</SPAN >)</H3 @@ -2425,13 +2283,13 @@ ><H2 CLASS="SECT1" ><A -NAME="AEN465">C.1. Kernel printer port support</H2 +NAME="AEN437">C.1. Kernel printer port support</H2 ><DIV CLASS="SECT2" ><H3 CLASS="SECT2" ><A -NAME="AEN467">C.1.1. About Kernel modules</H3 +NAME="AEN439">C.1.1. About Kernel modules</H3 ><P >The Linux kernel is the core of the operating system. Adding many features would reduce Linux's performance. The solution is to compile (build) the kernel with basic features that almost everyone will want, but to allow other features to be added on later as modules. Your printer will not work without kernel support. </P @@ -2453,13 +2311,13 @@ ><HR><H3 CLASS="SECT2" ><A -NAME="AEN474">C.1.2. Parallel printer support</H3 +NAME="AEN446">C.1.2. Parallel printer support</H3 ><DIV CLASS="SECT3" ><H4 CLASS="SECT3" ><A -NAME="AEN476">C.1.2.1. Check and install parallel printer support</H4 +NAME="AEN448">C.1.2.1. Check and install parallel printer support</H4 ><P >Run <SPAN CLASS="APPLICATION" @@ -2495,7 +2353,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN483">C.1.2.2. Select a module category</H4 +NAME="AEN455">C.1.2.2. Select a module category</H4 ><DIV CLASS="NOTE" ><P @@ -2517,7 +2375,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: Ncurses navigation</B +>Ncurses navigation</B ></TH ></TR ><TR @@ -2574,7 +2432,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN494">C.1.2.3. Check the status of parallel port modules</H4 +NAME="AEN466">C.1.2.3. Check the status of parallel port modules</H4 ><P >You already have parallel port support if you see plus signs (+). </P @@ -2816,7 +2674,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Warning: This section is untested</B +>This section is untested</B ></TH ></TR ><TR @@ -2829,8 +2687,8 @@ >I do not have a USB printer, so this is my 'best guess' at how to install one. If you get a USB printer working please let me know (<TT CLASS="EMAIL" ><<A -HREF="mailto:new...@co..." ->new...@co...</A +HREF="mailto:feedback.chrislale.@coolscience.co.uk" +>feedback.chrislale.@coolscience.co.uk</A >></TT >) and I will update this document. </P @@ -2843,7 +2701,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN538">C.1.3.1. Run <SPAN +NAME="AEN510">C.1.3.1. Run <SPAN CLASS="APPLICATION" >modconf</SPAN > from a terminal or terminal window.</H4 @@ -2882,7 +2740,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN546">C.1.3.2. Select a module category</H4 +NAME="AEN518">C.1.3.2. Select a module category</H4 ><DIV CLASS="NOTE" ><P @@ -2904,7 +2762,7 @@ ALIGN="LEFT" VALIGN="CENTER" ><B ->Note: Ncurses navigation</B +>Ncurses navigation</B ></TH ></TR ><TR @@ -2955,7 +2813,7 @@ ><HR><H4 CLASS="SECT3" ><A -NAME="AEN555">C.1.3.3. Check the status of USB port modules</H4 +NAME="AEN527">C.1.3.3. Check the status of USB port modules</H4 ><P >You already have USB printer support if you see a plus sign (+) against USB Printer support. </P @@ -3178,11 +3036,266 @@ ><P >Finished with this appendix! </P +><P +>Appendix: About this document + </P +></DIV +></DIV +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN567">C.2. Copyright information</H2 +><P +>Copyright ©2004 Chris Lale <TT +CLASS="EMAIL" +><<A +HREF="mailto:fee...@co..." +>fee...@co...</A +>></TT +>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. + </P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN571">C.3. Latest version</H2 +><P +>You can get the latest version of this document from <A +HREF="http://newbiedoc.sourceforge.net" +TARGET="_top" +>http://newbiedoc.sourceforge.net</A +>. + </P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN575">C.4. Bugs, errors and mistakes</H2 +><P +>If you find any errors, omissions etc, please let me know via the newbieDoc Discussion list <TT +CLASS="EMAIL" +><<A +HREF="mailto:new...@li..." +>new...@li...</A +>></TT +> or <TT +CLASS="EMAIL" +><<A +HREF="mailto:fee...@co..." +>fee...@co...</A +>></TT +>. + </P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="AEN580">C.5. Spelling, punctuation and grammar</H2 +><P +>I have written this document in English. I have used American spellings for some technical terms eg 'program' where these have become widely accepted. + </P +><P +>You can find guides to English spelling, punctuation and grammar at <A +HREF="http://www.cral.ac.uk/guidelines/" +TARGET="_top" +>http://www.cral.ac.uk/guidelines/</A +>. + </P +></DIV +><DIV +CLASS="SECT1" +><HR><H2 +CLASS="SECT1" +><A +NAME="SEC-DOCUMENT-CONVENTIONS">C.6. Conventions used in this document</H2 +><DIV +CLASS="SECT2" +><H3 +CLASS="SECT2" +><A +NAME="AEN587">C.6.1. Ellipsis</H3 +><P +>Three dots ... + </P +><P +></P +><UL +><LI +><P +>if before text, indicates text has been omitted in front of the text + </P +></LI +><LI +><P +>if after text, indicates that following text has been omitted. + </P +></LI +><LI +><P +>if on one line by themselves indicates that lines have been omitted. + </P +></LI +></UL +></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN597">C.6.2. Directory trees</H3 +><P +>A trailing forward slash (/) indicates that this is a directory, not a file. + </P ></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN600">C.6.3. Command line prompts</H3 +><P +>A '<TT +CLASS="FILENAME" +>$</TT +>' at the start of a line indicates that the rest of the line is input from a normal user. A '<TT +CLASS="FILENAME" +>#</TT +>' indicates that the Root user inputs the rest of the line. + </P +></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN605">C.6.4. File names, application names, package names and screen text</H3 +><P +>Filenames, application names, package names and text displayed by a console or terminal window look like this. + </P +><TABLE +BORDER="0" +BGCOLOR="#BBDDFF" +WIDTH="100%" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +><PRE +CLASS="SCREEN" +>my-file.txt +my-directory +/my-path/my-directory/ +<SPAN +CLASS="APPLICATION" +>my-application</SPAN +> +<SPAN +CLASS="APPLICATION" +>my-package</SPAN +> +This is some terminal text. + </PRE +></TD +></TR +></TABLE +><P +>Filenames, application names, package names and text displayed in an X window look like this. + </P +><TABLE +BORDER="0" +BGCOLOR="#BBDDFF" +WIDTH="100%" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +><PRE +CLASS="SYNOPSIS" +>my-file.txt +<SPAN +CLASS="APPLICATION" +>my-application</SPAN +> +<SPAN +CLASS="APPLICATION" +>my-package</SPAN +> +This is some text in an X window. + </PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT2" +><HR><H3 +CLASS="SECT2" +><A +NAME="AEN615">C.6.5. Commands</H3 +><P +>Commands issued from a terminal look like this. Use of the <ENTER> key is implied but not shown. + </P +><TABLE +BORDER="0" +BGCOLOR="#BBDDFF" +WIDTH="100%" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +><PRE +CLASS="SCREEN" +>$ <B +CLASS="COMMAND" +>my command</B +> + </PRE +></TD +></TR +></TABLE +><P +>This example shows a command issued in an X application. + </P +><TABLE +BORDER="0" +BGCOLOR="#BBDDFF" +WIDTH="100%" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +><PRE +CLASS="SYNOPSIS" +><SPAN +CLASS="emphasis" +><I +CLASS="EMPHASIS" +>Menu bar: </I +></SPAN +> <B +CLASS="COMMAND" +>File</B +> -> <B +CLASS="COMMAND" +>Close</B +> + </PRE +></TD +></TR +></TABLE ></DIV ></DIV ></DIV ></DIV ></BODY ></HTML -> +> \ No newline at end of file |
From: <new...@li...> - 2004-04-28 13:12:00
|
Newbiedoc CVS committal Author : chrislale Project : newbiedoc Module : peripherals Dir : newbiedoc/peripherals Modified Files: printer-cups.en.lyx printer-cups.en.sgml Log Message: Now run using standard nd-style.css =================================================================== RCS file: /cvsroot/newbiedoc/newbiedoc/peripherals/printer-cups.en.lyx,v retrieving revision 1.2 retrieving revision 1.3 diff -u -3 -r1.2 -r1.3 --- printer-cups.en.lyx 5 Mar 2004 17:36:21 -0000 1.2 +++ printer-cups.en.lyx 28 Apr 2004 13:11:44 -0000 1.3 @@ -27,7 +27,7 @@ \layout SGML <!--printer-cups.en.lyx, printer-cups.en.sgml Copyright (c) January 2004 Chris - Lale fee...@co.... + Lale <chrislale AT coolscience DOT co DOT uk>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 @@ -50,18 +50,31 @@ \layout Email -fe...@co... +ch...@us... \layout RevisionHistory \layout Revision +0.02 +\layout Date + +28 April 2004 +\layout Initials + +cl +\layout RevisionRemark + +Added meta keywords. + Moved 'About this document' to an appendix. +\layout Revision + 0.01 \layout Date 6th February 2004 \layout Initials -CL +cl \layout RevisionRemark First release. @@ -70,156 +83,126 @@ This document was composed using LyX qt version 1.3.3, exported to sgml and rendered to HTML using the newbieDoc style sheets and tools available from -\begin_inset LatexCommand \url[http://newbiedoc.sourceforge.net]{http://newbiedoc.sourceforge.net} +\begin_inset LatexCommand \url[http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz]{http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz} \end_inset . -\layout Abstract - -This document describes how to install and configure a printer using CUPS - (the Common UNIX Printing System). - The setup described in this document is known to work with Debian GNU/Linux - 3.0 (Woody) and CUPS version 1.1.14-3. -\layout Section +\layout KeywordSet -About this document -\layout Subsection - -Copyright information -\layout Standard +\layout Keyword -Copyright ©2004 Chris Lale ( -\begin_inset LatexCommand \htmlurl[fee...@co...]{mailto:fee...@co...} - -\end_inset - -). - Permission is granted to copy, distribute and/or modify this document with - no Invariant Sections, with no Front-Cover texts and with no Back-Cover - Texts under the terms of the GNU Free Documentation License, version 1.1 - or any later version, published by the Free Software Foundation. - A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. - -\layout Subsection +Debian +\layout Keyword -Latest version -\layout Standard +GNU +\layout Keyword -You can get the latest version of this document from -\begin_inset LatexCommand \url[http://newbiedoc.sourceforge.net]{http://newbiedoc.sourceforge.net} +Linux +\layout Keyword -\end_inset +print +\layout Keyword -. -\layout Subsection +printer +\layout Keyword -Bugs, errors and mistakes -\layout Standard +CUPS +\layout Keyword -If you find any errors, omissions etc, please let me know. - My email address is at the top of this document. -\layout Subsection +newbie +\layout Keyword -Spelling, punctuation and grammar -\layout Standard +configure +\layout Keyword -I have written this document in English. - I have used American spellings for some technical terms eg 'dialog', 'disk' - and 'program' where these have become widely accepted. -\layout Standard +setup +\layout Keyword -Deciding how to use program names and package names at the beginning of - a sentance is always a problem. - Sentences should always begin with a capital letter, but program names - and package names usually begin with a lower-case letter. - I was ploughing through some man pages one day when I noticed that the - program name often appeared in capital letters at the top, left-hand corner. - I have taken a similar approach. - In the source document I write program names and package names in lower - case. - I tag them so that they are rendered in a 'small caps' font in the final - document. -\layout Standard +install +\layout Keyword -You can find guides to English spelling, punctuation and grammar at -\begin_inset LatexCommand \url[http://www.cral.ac.uk/guidelines/]{http://www.cral.ac.uk/guidelines/} +HOWTO +\layout Abstract -\end_inset +This document describes how to install and configure a printer using CUPS + (the Common UNIX Printing System). + The setup described in this document is known to work with Debian GNU/Linux + 3.0 (Woody) and CUPS version 1.1.14-3. +\layout Section -. +Introduction \layout Subsection -Conventions used in this document -\layout Subsubsection - -Command line prompts -\layout Standard - -A +About \begin_inset ERT status Collapsed \layout Standard -<filename> +<application> \end_inset - +lpr \begin_inset ERT status Collapsed \layout Standard -$ +</application> \end_inset - + and \begin_inset ERT status Collapsed \layout Standard -</filename> +<application> \end_inset - at the start of a line indicates that the rest of the line is input from - a normal user. - A +lprng \begin_inset ERT status Collapsed \layout Standard -<filename> +</application> \end_inset +\layout Standard + + \begin_inset ERT status Collapsed \layout Standard -# +<application> \end_inset - +lpr/lpd \begin_inset ERT status Collapsed \layout Standard -</filename> +</application> \end_inset - indicates that the Root user inputs the rest of the line. -\layout Subsubsection + is the BSD line printer spooling system. + +\begin_inset ERT +status Collapsed -File names, application names, package names and screen text \layout Standard +<application> +\end_inset -Filenames, application names, package names and text displayed by a console - or terminal window look like this. -\layout Screen - -my-file.txt -\layout Screen +lprng +\begin_inset ERT +status Collapsed +\layout Standard +</application> +\end_inset + is an enhanced, extended, and portable version of \begin_inset ERT status Collapsed @@ -227,7 +210,7 @@ <application> \end_inset -my-application +lpr \begin_inset ERT status Collapsed @@ -235,10 +218,8 @@ </application> \end_inset - -\layout Screen - - +. + \begin_inset ERT status Collapsed @@ -246,7 +227,7 @@ <application> \end_inset -my-package +lpr \begin_inset ERT status Collapsed @@ -254,20 +235,25 @@ </application> \end_inset + is the system that is installed by default on a standard Debian 3.0 installation. + If you have a non-PostScript printer, you must create a filter file called + +\begin_inset ERT +status Collapsed -\layout Screen - -This is some terminal text. \layout Standard +<filename> +\end_inset -Filenames, application names, package names and text displayed in an X window - look like this. -\layout XScreen - -my-file.txt -\layout XScreen +/etc/printcap +\begin_inset ERT +status Collapsed +\layout Standard +</filename> +\end_inset + (normally using \begin_inset ERT status Collapsed @@ -275,7 +261,7 @@ <application> \end_inset -my-application +apsfilter \begin_inset ERT status Collapsed @@ -283,10 +269,7 @@ </application> \end_inset - -\layout XScreen - - + or \begin_inset ERT status Collapsed @@ -294,7 +277,7 @@ <application> \end_inset -my-package +magicfilter \begin_inset ERT status Collapsed @@ -302,74 +285,44 @@ </application> \end_inset - -\layout XScreen - -This is some text in an X window. -\layout Subsubsection - -Commands -\layout Standard - -Commands issued from a terminal look like this. - Use of the <Enter> key is implied but not shown. -\layout Screen - -$ +). + Together with the \begin_inset ERT status Collapsed \layout Standard -<command> +<application> \end_inset -my command +ghostscript \begin_inset ERT status Collapsed \layout Standard -</command> +</application> \end_inset - + PostScript interpreter, the filter turns your PostScript output into the + output needed for a non-PostScript printer. \layout Standard -The 3rd line in this example shows a command issued in X. -\layout XScreen - - -\emph on -Menu bar -\layout XScreen - - File -\layout XScreen - - +This document is describes \begin_inset ERT status Collapsed \layout Standard -<command> +<application> \end_inset -Close +cups \begin_inset ERT status Collapsed \layout Standard -</command> +</application> \end_inset - -\layout XScreen - -\layout Section - -Introduction -\layout Subsection - -About +, not \begin_inset ERT status Collapsed @@ -385,7 +338,8 @@ </application> \end_inset - and +. + If you wish to use \begin_inset ERT status Collapsed @@ -393,7 +347,7 @@ <application> \end_inset -lprng +lpr \begin_inset ERT status Collapsed @@ -401,10 +355,7 @@ </application> \end_inset - -\layout Standard - - +, read the document describing how to configure printing using \begin_inset ERT status Collapsed @@ -412,7 +363,7 @@ <application> \end_inset -lpr/lpd +lpr \begin_inset ERT status Collapsed @@ -420,8 +371,16 @@ </application> \end_inset - is the BSD line printer spooling system. + at +\begin_inset LatexCommand \htmlurl[http://newbiedoc.sourceforge.net/peripherals/printer-magicfilter.html]{http://newbiedoc.sourceforge.net/peripherals/printer-magicfilter.html} + +\end_inset + +. +\layout Subsection + +About \begin_inset ERT status Collapsed @@ -429,7 +388,7 @@ <application> \end_inset -lprng +cups \begin_inset ERT status Collapsed @@ -437,7 +396,10 @@ </application> \end_inset - is an enhanced, extended, and portable version of + +\layout Standard + + \begin_inset ERT status Collapsed @@ -445,7 +407,7 @@ <application> \end_inset -lpr +cups \begin_inset ERT status Collapsed @@ -453,8 +415,8 @@ </application> \end_inset -. - + is the Common UNIX Printing System it is a replacement for replacement + for \begin_inset ERT status Collapsed @@ -470,25 +432,24 @@ </application> \end_inset - is the system that is installed by default on a standard Debian 3.0 installation. - If you have a non-PostScript printer, you must create a filter file called - + and \begin_inset ERT status Collapsed \layout Standard -<filename> +<application> \end_inset -/etc/printcap +lprng \begin_inset ERT status Collapsed \layout Standard -</filename> +</application> \end_inset - (normally using +. + \begin_inset ERT status Collapsed @@ -496,7 +457,7 @@ <application> \end_inset -apsfilter +lpr \begin_inset ERT status Collapsed @@ -512,7 +473,7 @@ <application> \end_inset -magicfilter +lprng \begin_inset ERT status Collapsed @@ -520,203 +481,7 @@ </application> \end_inset -). - Together with the -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -ghostscript -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - PostScript interpreter, the filter turns your PostScript output into the - output needed for a non-PostScript printer. -\layout Standard - -This document is describes -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -cups -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - -, not -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lpr -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - -. - If you wish to use -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lpr -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - -, read the document describing how to configure printing using -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lpr -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - at -\begin_inset LatexCommand \htmlurl[http://newbiedoc.sourceforge.net/peripherals/printer-magicfilter.html]{http://newbiedoc.sourceforge.net/peripherals/printer-magicfilter.html} - -\end_inset - -. - -\layout Subsection - -About -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -cups -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - -\layout Standard - - -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -cups -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - is the Common UNIX Printing System it is a replacement for replacement - for -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lpr -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - and -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lprng -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - -. - -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lpr -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - or -\begin_inset ERT -status Collapsed - -\layout Standard -<application> -\end_inset - -lprng -\begin_inset ERT -status Collapsed - -\layout Standard -</application> -\end_inset - - will be removed, but your existing + will be removed, but your existing \begin_inset ERT status Collapsed @@ -2275,7 +2040,7 @@ database (optional) \layout NoteTitle - The +The \begin_inset ERT status Collapsed @@ -2452,7 +2217,7 @@ Choose the default settings if you are not sure. \layout NoteTitle - Ncurses navigation +Ncurses navigation \layout Note Use the arrow keys and the <Tab> key to make your selection. @@ -2950,7 +2715,7 @@ using a web browser \layout NoteTitle - Browser variations +Browser variations \layout Note You can find login instructions for various browsers (both X and console @@ -5605,4 +5370,344 @@ \layout Standard Finished with this appendix! +\layout Standard + +Appendix: About this document +\layout Section + +Copyright information +\layout Standard + +Copyright ©2004 Chris Lale +\begin_inset ERT +status Collapsed + +\layout Standard +<email>fee...@co...</email> +\end_inset + +. + Permission is granted to copy, distribute and/or modify this document with + no Invariant Sections, with no Front-Cover texts and with no Back-Cover + Texts under the terms of the GNU Free Documentation License, version 1.1 + or any later version, published by the Free Software Foundation. + A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. + +\layout Section + +Latest version +\layout Standard + +You can get the latest version of this document from +\begin_inset LatexCommand \url[http://newbiedoc.sourceforge.net]{http://newbiedoc.sourceforge.net} + +\end_inset + +. +\layout Section + +Bugs, errors and mistakes +\layout Standard + +If you find any errors, omissions etc, please let me know via the newbieDoc + Discussion list +\begin_inset ERT +status Collapsed + +\layout Standard +<email>new...@li...</email> +\end_inset + + or +\begin_inset ERT +status Collapsed + +\layout Standard +<email>fee...@co...</email> +\end_inset + +. +\layout Section + +Spelling, punctuation and grammar +\layout Standard + +I have written this document in English. + I have used American spellings for some technical terms eg 'program' where + these have become widely accepted. +\layout Standard + +You can find guides to English spelling, punctuation and grammar at +\begin_inset LatexCommand \url[http://www.cral.ac.uk/guidelines/]{http://www.cral.ac.uk/guidelines/} + +\end_inset + +. +\layout Section + + +\begin_inset LatexCommand \label{sec-Document-conventions} + +\end_inset + +Conventions used in this document +\layout Subsection + +Ellipsis +\layout Standard + +Three dots ... + +\layout Itemize + +if before text, indicates text has been omitted in front of the text +\layout Itemize + +if after text, indicates that following text has been omitted. +\layout Itemize + +if on one line by themselves indicates that lines have been omitted. +\layout Subsection + +Directory trees +\layout Standard + +A trailing forward slash ( +\begin_inset ERT +status Collapsed + +\layout Standard +/ +\end_inset + +) indicates that this is a directory, not a file. +\layout Subsection + +Command line prompts +\layout Standard + +A ' +\begin_inset ERT +status Collapsed + +\layout Standard +<filename> +\end_inset + + +\begin_inset ERT +status Collapsed + +\layout Standard +$ +\end_inset + + +\begin_inset ERT +status Collapsed + +\layout Standard +</filename> +\end_inset + +' at the start of a line indicates that the rest of the line is input from + a normal user. + A ' +\begin_inset ERT +status Collapsed + +\layout Standard +<filename> +\end_inset + + +\begin_inset ERT +status Collapsed + +\layout Standard +# +\end_inset + + +\begin_inset ERT +status Collapsed + +\layout Standard +</filename> +\end_inset + +' indicates that the Root user inputs the rest of the line. +\layout Subsection + +File names, application names, package names and screen text +\layout Standard + +Filenames, application names, package names and text displayed by a console + or terminal window look like this. +\layout Screen + +my-file.txt +\layout Screen + +my-directory +\layout Screen + +/my-path/my-directory/ +\layout Screen + + +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +my-application +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + +\layout Screen + + +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +my-package +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + +\layout Screen + +This is some terminal text. +\layout Standard + +Filenames, application names, package names and text displayed in an X window + look like this. +\layout XScreen + +my-file.txt +\layout XScreen + + +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +my-application +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + +\layout XScreen + + +\begin_inset ERT +status Collapsed + +\layout Standard +<application> +\end_inset + +my-package +\begin_inset ERT +status Collapsed + +\layout Standard +</application> +\end_inset + + +\layout XScreen + +This is some text in an X window. +\layout Subsection + +Commands +\layout Standard + +Commands issued from a terminal look like this. + Use of the <ENTER> key is implied but not shown. +\layout Screen + +$ +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +my command +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + +\layout Standard + +This example shows a command issued in an X application. +\layout XScreen + + +\emph on +Menu bar: +\emph default + +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +File +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + -> +\begin_inset ERT +status Collapsed + +\layout Standard +<command> +\end_inset + +Close +\begin_inset ERT +status Collapsed + +\layout Standard +</command> +\end_inset + + \the_end =================================================================== RCS file: /cvsroot/newbiedoc/newbiedoc/peripherals/printer-cups.en.sgml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -3 -r1.2 -r1.3 --- printer-cups.en.sgml 5 Mar 2004 17:36:21 -0000 1.2 +++ printer-cups.en.sgml 28 Apr 2004 13:11:46 -0000 1.3 @@ -4,7 +4,7 @@ <!-- DocBook file was created by LyX 1.3 See http://www.lyx.org/ for more information --> -<!--printer-cups.en.lyx, printer-cups.en.sgml Copyright (c) January 2004 Chris Lale fee...@co.... Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. --> +<!--printer-cups.en.lyx, printer-cups.en.sgml Copyright (c) January 2004 Chris Lale <chrislale AT coolscience DOT co DOT uk>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. --> <title> Setting up a printer on a Debian GNU/Linux PC using CUPS @@ -25,7 +25,7 @@ <address> <email> -fe...@co... +ch...@us... </email> </address> @@ -43,16 +43,32 @@ <revision> <revnumber> +0.02 + </revnumber> + <date> +28 April 2004 + </date> + <authorinitials> +cl + </authorinitials> + <revremark> +Added meta keywords. Moved 'About this document' to an appendix. + </revremark> + + </revision> + + <revision> + <revnumber> 0.01 </revnumber> <date> 6th February 2004 </date> <authorinitials> -CL +cl </authorinitials> <revremark> -First release. Developed and tested using Debian GNU/Linux 3.0 (Woody) and the Debian package CUPS version 1.1.14-3. This document was composed using LyX qt version 1.3.3, exported to sgml and rendered to HTML using the newbieDoc style sheets and tools available from <ulink url="http://newbiedoc.sourceforge.net">http://newbiedoc.sourceforge.net</ulink>. +First release. Developed and tested using Debian GNU/Linux 3.0 (Woody) and the Debian package CUPS version 1.1.14-3. This document was composed using LyX qt version 1.3.3, exported to sgml and rendered to HTML using the newbieDoc style sheets and tools available from <ulink url="http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz">http://newbiedoc.sourceforge.net/tarballs/newbiedoc-lyx-files_0.02.tar.gz</ulink>. </revremark> </revision> @@ -60,6 +76,45 @@ </revhistory> + <keywordset> + + + <keyword> +Debian + </keyword> + <keyword> +GNU + </keyword> + <keyword> +Linux + </keyword> + <keyword> +print + </keyword> + <keyword> +printer + </keyword> + <keyword> +CUPS + </keyword> + <keyword> +newbie + </keyword> + <keyword> +configure + </keyword> + <keyword> +setup + </keyword> + <keyword> +install + </keyword> + <keyword> +HOWTO + </keyword> + + </keywordset> + <abstract> <para> This document describes how to install and configure a printer using CUPS (the Common UNIX Printing System). The setup described in this document is known to work with Debian GNU/Linux 3.0 (Woody) and CUPS version 1.1.14-3. @@ -72,127 +127,6 @@ <sect1> <title> -About this document - </title> - <sect2> - <title> -Copyright information - </title> - <para> -Copyright ©2004 Chris Lale (<ulink url="mailto:fee...@co...">fee...@co...</ulink>). Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. - </para> - - </sect2> - - <sect2> - <title> -Latest version - </title> - <para> -You can get the latest version of this document from <ulink url="http://newbiedoc.sourceforge.net">http://newbiedoc.sourceforge.net</ulink>. - </para> - - </sect2> - - <sect2> - <title> -Bugs, errors and mistakes - </title> - <para> -If you find any errors, omissions etc, please let me know. My email address is at the top of this document. - </para> - - </sect2> - - <sect2> - <title> -Spelling, punctuation and grammar - </title> - <para> -I have written this document in English. I have used American spellings for some technical terms eg 'dialog', 'disk' and 'program' where these have become widely accepted. - </para> - <para> -Deciding how to use program names and package names at the beginning of a sentance is always a problem. Sentences should always begin with a capital letter, but program names and package names usually begin with a lower-case letter. I was ploughing through some man pages one day when I noticed that the program name often appeared in capital letters at the top, left-hand corner. I have taken a similar approach. In the source document I write program names and package names in lower case. I tag them so that they are rendered in a 'small caps' font in the final document. - </para> - <para> -You can find guides to English spelling, punctuation and grammar at <ulink url="http://www.cral.ac.uk/guidelines/">http://www.cral.ac.uk/guidelines/</ulink>. - </para> - - </sect2> - - <sect2> - <title> -Conventions used in this document - </title> - <sect3> - <title> -Command line prompts - </title> - <para> -A <filename>$</filename> at the start of a line indicates that the rest of the line is input from a normal user. A <filename>#</filename> indicates that the Root user inputs the rest of the line. - </para> - - </sect3> - - <sect3> - <title> -File names, application names, package names and screen text - </title> - <para> -Filenames, application names, package names and text displayed by a console or terminal window look like this. - </para> - <screen> -<![CDATA[my-file.txt -]]><![CDATA[]]><application><![CDATA[my-application]]></application><![CDATA[ -]]><![CDATA[]]><application><![CDATA[my-package]]></application><![CDATA[ -]]><![CDATA[This is some terminal text. -]]> - </screen> - <para> -Filenames, application names, package names and text displayed in an X window look like this. - </para> - <synopsis> -<![CDATA[my-file.txt -]]><![CDATA[]]><application><![CDATA[my-application]]></application><![CDATA[ -]]><![CDATA[]]><application><![CDATA[my-package]]></application><![CDATA[ -]]><![CDATA[This is some text in an X window. -]]> - </synopsis> - - </sect3> - - <sect3> - <title> -Commands - </title> - <para> -Commands issued from a terminal look like this. Use of the <Enter> key is implied but not shown. - </para> - <screen> -<![CDATA[$ ]]><command><![CDATA[my command]]></command><![CDATA[ -]]> - </screen> - <para> -The 3rd line in this example shows a command issued in X. - </para> - <synopsis> -<![CDATA[]]><emphasis><![CDATA[Menu bar]]></emphasis><![CDATA[ -]]><![CDATA[ File -]]><![CDATA[ ]]><command><![CDATA[Close]]></command><![CDATA[ -]]><![CDATA[ -]]> - </synopsis> - - </sect3> - - - </sect2> - - - </sect1> - - <sect1> - <title> Introduction </title> <sect2> @@ -1176,6 +1110,9 @@ <para> Finished with this appendix! </para> + <para> +Appendix: About this document + </para> </sect3> @@ -1185,6 +1122,157 @@ </sect1> + <sect1> + <title> +Copyright information + </title> + <para> +Copyright ©2004 Chris Lale <email>fee...@co...</email>. Permission is granted to copy, distribute and/or modify this document with no Invariant Sections, with no Front-Cover texts and with no Back-Cover Texts under the terms of the GNU Free Documentation License, version 1.1 or any later version, published by the Free Software Foundation. A copy of the license can be found at http://www.fsf.org/copyleft/fdl.html. + </para> + + </sect1> + + <sect1> + <title> +Latest version + </title> + <para> +You can get the latest version of this document from <ulink url="http://newbiedoc.sourceforge.net">http://newbiedoc.sourceforge.net</ulink>. + </para> + + </sect1> + + <sect1> + <title> +Bugs, errors and mistakes + </title> + <para> +If you find any errors, omissions etc, please let me know via the newbieDoc Discussion list <email>new...@li...</email> or <email>fee...@co...</email>. + </para> + + </sect1> + + <sect1> + <title> +Spelling, punctuation and grammar + </title> + <para> +I have written this document in English. I have used American spellings for some technical terms eg 'program' where these have become widely accepted. + </para> + <para> +You can find guides to English spelling, punctuation and grammar at <ulink url="http://www.cral.ac.uk/guidelines/">http://www.cral.ac.uk/guidelines/</ulink>. + </para> + + </sect1> + + <sect1 id="sec-Document-conventions"> + <title> +Conventions used in this document + </title> + <sect2> + <title> +Ellipsis + </title> + <para> +Three dots ... + </para> + <itemizedlist> + <listitem> + <para> +if before text, indicates text has been omitted in front of the text + </para> + + </listitem> + <listitem> + <para> +if after text, indicates that following text has been omitted. + </para> + + </listitem> + <listitem> + <para> +if on one line by themselves indicates that lines have been omitted. + </para> + + </listitem> + + </itemizedlist> + + </sect2> + + <sect2> + <title> +Directory trees + </title> + <para> +A trailing forward slash (/) indicates that this is a directory, not a file. + </para> + + </sect2> + + <sect2> + <title> +Command line prompts + </title> + <para> +A '<filename>$</filename>' at the start of a line indicates that the rest of the line is input from a normal user. A '<filename>#</filename>' indicates that the Root user inputs the rest of the line. + </para> + + </sect2> + + <sect2> + <title> +File names, application names, package names and screen text + </title> + <para> +Filenames, application names, package names and text displayed by a console or terminal window look like this. + </para> + <screen> +<![CDATA[my-file.txt +]]><![CDATA[my-directory +]]><![CDATA[/my-path/my-directory/ +]]><![CDATA[]]><application><![CDATA[my-application]]></application><![CDATA[ +]]><![CDATA[]]><application><![CDATA[my-package]]></application><![CDATA[ +]]><![CDATA[This is some terminal text. +]]> + </screen> + <para> +Filenames, application names, package names and text displayed in an X window look like this. + </para> + <synopsis> +<![CDATA[my-file.txt +]]><![CDATA[]]><application><![CDATA[my-application]]></application><![CDATA[ +]]><![CDATA[]]><application><![CDATA[my-package]]></application><![CDATA[ +]]><![CDATA[This is some text in an X window. +]]> + </synopsis> + + </sect2> + + <sect2> + <title> +Commands + </title> + <para> +Commands issued from a terminal look like this. Use of the <ENTER> key is implied but not shown. + </para> + <screen> +<![CDATA[$ ]]><command><![CDATA[my command]]></command><![CDATA[ +]]> + </screen> + <para> +This example shows a command issued in an X application. + </para> + <synopsis> +<![CDATA[]]><emphasis><![CDATA[Menu bar: ]]></emphasis><![CDATA[ ]]><command><![CDATA[File]]></command><![CDATA[ -> ]]><command><![CDATA[Close]]></command><![CDATA[ +]]> + </synopsis> + + </sect2> + + + </sect1> + </appendix> |