Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
Hi, On Mon, Oct 03, 2016 at 04:01:44PM -0400, Bob Bernstein wrote: > > You can see several Debian document sources to know how we build > > document from there. > > Sorry to so dense, but can you please clarify this observation for me? Where > might these document sources be available? If it is Debian package, you can download source by $ apt-get source See also the list of documents in https://www.debian.org/doc/user-manuals You can see links under: Debian Installation Guide Debian reference Debian Reference Card The Debian Administrator's Handbook Debian Release Notes New upstream site at https://anonscm.debian.org/cgit/debwww/cron.git/tree/ Osamu
Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
On Sat, 1 Oct 2016, Osamu Aoki wrote: You do not need to use all the tags in Docbook XML. Understood. The smaller tag set is one of DebianDoc's virtues imho. You can see several Debian document sources to know how we build document from there. Sorry to so dense, but can you please clarify this observation for me? Where might these document sources be available? Thanks, -- IMPORTANT: This email is intended for the use of the individual addressee(s) named above and may contain information that is confidential, privileged or unsuitable for overly sensitive persons with low self-esteem, no sense of humour or irrational metaphysical beliefs.
Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
On Sat, 1 Oct 2016, Osamu Aoki wrote: debiandoc-sgml now comes with debiandoc2dbk. That is wonderful news to my ears. I _have to_ to look at that package. I am actually wanting to use DocBook less and DebianDoc more (I know, sounds regressive -- that's me.), but at least now that there is some interest in it perhaps it won't fall so quickly by the wayside. Thank you also for all the XSLT examples. I once had quite an interest in XSLT stylesheets, due mostly to Bob Stayton's book, which is around here on a drive somewhere. I just knew DebianDoc had to have an advocate somewhere, and I think I've found him! All best, -- IMPORTANT: This email is intended for the use of the individual addressee(s) named above and may contain information that is confidential, privileged or unsuitable for overly sensitive persons with low self-esteem, no sense of humour or irrational metaphysical beliefs.
Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
Hi, Oops... On Sat, Oct 01, 2016 at 07:49:55AM +0900, Osamu Aoki wrote: > HI, > > On Fri, Sep 30, 2016 at 11:50:03AM -0400, Bob Bernstein wrote: > > Please forgive me this cross-post from debian-user. > > > > -- snip -- > ... > > Thanks all, and please let's not allow debiandoc to wither on the vine. > > debiandoc-sgml now comes with debiandoc2dbk. If you wish to migrate > tags to new Docbook XML, this does most of the conversion for you. > > You do not need to use all the tags in Docbook XML. > > You can see several Debian document sources to know how we build > document from there. > > For HTML, nwalsh's stylesheet and xslt command. > xsltproc --novalid --nonet your-xml-source.dbk Wrong. You need to call nwalsh's stylesheet by something like (Untested) xsltproc --novalid --nonet --xinclude \ /usr/share/xml/docbook/stylesheet/docbook-xsl/xhtml-1_1/chunk.xsl \ your-xml-source.dbk > You can customize html build with XSL stylesheet > xsltproc --novalid --nonet --xinclude stylesheet.xsl your-xml-source.dbk Of course your stylesheet.xsl needs to be like (You need some adjustment): http://www.w3.org/1999/XSL/Transform; version="1.0"> http://www.w3.org/1999/xhtml; name="head.content.generator"> debian-reference.css index .png 4 (This is from debian-reference but maint-guide etc may also be referenced.) > I recommend to use dblatex to build PDF. > > Osamu >
Re: LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
HI, On Fri, Sep 30, 2016 at 11:50:03AM -0400, Bob Bernstein wrote: > Please forgive me this cross-post from debian-user. > > -- snip -- ... > Thanks all, and please let's not allow debiandoc to wither on the vine. debiandoc-sgml now comes with debiandoc2dbk. If you wish to migrate tags to new Docbook XML, this does most of the conversion for you. You do not need to use all the tags in Docbook XML. You can see several Debian document sources to know how we build document from there. For HTML, nwalsh's stylesheet and xslt command. xsltproc --novalid --nonet your-xml-source.dbk You can customize html build with XSL stylesheet xsltproc --novalid --nonet --xinclude stylesheet.xsl your-xml-source.dbk I recommend to use dblatex to build PDF. Osamu
LONG LIVE DEBIANDOC (was: How to edit debiandoc in emacs with nxml)
Please forgive me this cross-post from debian-user. -- snip -- I appended this to my sources.list: deb http://debian.csail.mit.edu/debian/ wheezy main contrib non-free and then ran: # apt-get update I kept rerunning: # apt-get install --dry-run emacs23 until all the warnings subsided, meaning all the dependency problems were going to be resolved. It looked like this: # apt-get install --dry-run emacs23-el emacs23-common emacs23-bin-common libjpeg8 libtiff4 Then I removed the '--dry-run' option and ran the apt-get install for real. It went smooth as silk, but -- more importantly for my purposes -- the resultant emacs23 ran perfectly with psgmlx and a debiandoc sgml document I had been using as test doc! NB. I had installed viz. byte-compiled the psgmlx package with the emacs23 I yesterday built from source grabbed on http://ftp.gnu.org/gnu/ . I am psyched. Now to post this over on the debian-doc list so the "answer" is there too. As one who in an earlier incarnation made a fairly good, if occasional, buck tech-writing and -editing on linux topics (which income came to an abrupt halt when the "internet bubble" collapsed), I am here to say that debiandoc is an excellent publishing tool-chain. It is blessedly simple but complete for my needs, which means it is actually FUN to use! Thanks all, and please let's not allow debiandoc to wither on the vine. -- IMPORTANT: This email is intended for the use of the individual addressee(s) named above and may contain information that is confidential, privileged or unsuitable for overly sensitive persons with low self-esteem, no sense of humour or irrational metaphysical beliefs.