discuss: Return of the Prodigal HOWTO: Linux Complete Backup and Recovery HOWTO
Subject:
Re: Return of the Prodigal HOWTO: Linux Complete Backup and Recovery
HOWTO
From:
"Martin A. Brown" ####@####.####
Date:
13 Jul 2017 02:16:17 +0100
Message-Id: <alpine.LSU.2.11.1707121751500.5345@znpeba.jbaqresebt.arg>
Hello and welcome back,
I read a great deal of the mailing list archive about a year ago and
I saw your name often, Charles Curley.
>I am the original author and maintainer of the Linux Complete
>Backup and Recovery HOWTO. The last version on the LDP web site is
>2.1. I am now up to 2.10. Do you want the most recent version?
Certainly.
>It is in Docbook 4.1 in SGML, with some includes.
The earlier release of your document is in our repository as a
DocBook V4.1 document -- should work just fine.
I did make a small change to your tooling [0] [1] to generate your
included files and commit them to the repository so that our
automatic publishing could read the derived files from checkout
(rather than executing a script that was checked out of the
repository itself). If this is not unduly offensive to you, I'd
happily adjust what we have committed to reflect your updated
content. (I.e. essentially, I'd reapply my small patch just so that
we could safely, automatically, rebuild at will straight from the
checkout.)
>I had a cvs account, but I seem to recall that that went away. Is
>there a git replacement? What's the preferred way to maintain?
For source control, there is a git replacement for the (now defunct)
CVS repository. Here's the TLDP canonical repository:
https://github.com/tLDP/LDP
We use a fork and PR model like many other organizations who have
elected to use github.
We also have tooling to automatically generate text, PDF, HTML
(single-page and chapter) outputs for each of the source documents
in the source repository. This job runs under a continuous
integration model (thanks to Serge) and produces a single merged
output directory with a single directory for each output type. For
example, for your document, you can see:
http://www.tldp.org/en/Linux-Complete-Backup-and-Recovery-HOWTO/
http://www.tldp.org/en/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO-single.html
http://www.tldp.org/en/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.txt
http://www.tldp.org/en/Linux-Complete-Backup-and-Recovery-HOWTO/Linux-Complete-Backup-and-Recovery-HOWTO.pdf
There's one Achilles heel in that these generated documents and
their structure are not reflected through the "front door" of TLDP
yet.
If anybody is interested in taking on some responsibility for
helping re-organize and manage the content, I have notes (some of
which I shared on this mailing list) from my own efforts of about a
year ago to sift through the 20 years of links, archives, magazine
articles and so forth.
Anyway, that's the current state of things over here and we'd be
happy for the updates.
Thank you very much for your contributions over the years!
-Martin
[0] https://github.com/tLDP/LDP/commit/d51e1970c49ee15593a3ec2bf5a0ef6078f40058
[1] https://github.com/tLDP/LDP/commits/master/LDP/howto/docbook/Linux-Complete-Backup-and-Recovery-HOWTO
--
Martin A. Brown
http://linux-ip.net/
