discuss: Re: New document: Linux and Android HOWTO
Subject:
Re: New document: Linux and Android HOWTO
From:
Rick Moen ####@####.####
Date:
8 Mar 2016 15:46:43 +0000
Message-Id: <20160308154732.GX21547@linuxmafia.com>
Quoting ####@####.#### ####@####.####
> I started to review the HOWTO, but I found it too distracting to try
> to review it with the sgml markup, so I'd ask these questions:
>
> Is there an easy way to view the document on the Internet (i.e.,
> without downloading it) in formatted (rendered) form?
I can't answer that, but I can help you with other stuff:
> How can I easily download that file to my computer (I use Linux if it
> matters-- I'm really just looking for a link--"Save Page As" doesn't
> seem to be what I what)?
Just trying this experimentally:
$ cd /tmp
$ wget https://github.com/tLDP/LDP/blob/master/LDP/inprogress/Linux-Android-HOWTO.sgml
--2016-03-08 07:21:20--
https://github.com/tLDP/LDP/blob/master/LDP/inprogress/Linux-Android-HOWTO.sgml
Resolving github.com... 192.30.252.130
Connecting to github.com|192.30.252.130|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: unspecified [text/html]
Saving to: "Linux-Android-HOWTO.sgml"
[ <=> ] 458,989 85.9K/s in 5.2s
2016-03-08 07:21:31 (86.8 KB/s) - "Linux-Android-HOWTO.sgml" saved [458989]
$
...and, hmm, no, that's not the SGML file at all, but rather a poxy bunch
of HTML5 from GitHub. So, angle back to the page: Toolbar includes a
button labeled 'Raw'. Select that. You are taken to
https://raw.githubusercontent.com/tLDP/LDP/master/LDP/inprogress/Linux-Android-HOWTO.sgml .
That 'page', if you Save As, _is_ (enfin) the actual intended SGML file.
Or, you can fetch via command line (now that you have the direct URL of
the raw version) this way:
$ wget --no-check-certificate https://raw.githubusercontent.com/tLDP/LDP/master/LDP/inprogress/Linux-Android-HOWTO.sgml
Looking at the first line of the document, the SGML declaration, reveals
what _flavour_ of SGML it is, a critical distinction. (Saying it's SGML
is analogous to saying 'What sort of car was it? I'm pretty sure the
brand was something like "Automobile".')
<!doctype linuxdoc system>
Aha, LinuxDoc SGML. LinuxDoc is a very light, visually transparent sort
of semantic markup. You might want to give a try to reading it in
un-rendered form and seeing how that works. My LDP document in LinuxDoc
is IMO a very easy format to work with. (There, I said it. David
Lawyer is not the only fan of the old thing.)
But, to render it, get a copy of the linuxdoc parsing program (package),
and do:
$ linuxdoc -B html Linux-Android-HOWTO.sgml
Processing file Linux-Android-HOWTO.sgml
$
Default output (without fancy options) is:
$ ls Linux-Android-HOWTO*.html
Linux-Android-HOWTO-10.html Linux-Android-HOWTO-6.html
Linux-Android-HOWTO-1.html Linux-Android-HOWTO-7.html
Linux-Android-HOWTO-2.html Linux-Android-HOWTO-8.html
Linux-Android-HOWTO-3.html Linux-Android-HOWTO-9.html
Linux-Android-HOWTO-4.html Linux-Android-HOWTO.html
Linux-Android-HOWTO-5.html
$
And there you have it. Have fun! (Or, as our SuSE friends say,
'Have a lot of fun.')