name mode size
Licenses 040000
Old HTML Version 040000
XSLT Sheets 040000
css 040000
.gitignore 100644 28B 100644 2.23kB
Some_Puppy_Linux_Basics.xml 100644 237.33kB
# Some Puppy Linux Basics by Apollia - An old educational page I wrote in maybe Feb-Apr of 2013, then converted to XML/XSLT in June 2017. Scarcely changed since April 2013. . It should be possible to view the XML version in any recent web browser. The web browser should automatically and instantly use the included XSLT 1.0 stylesheet to properly format the XML version. If all goes well, it should look nearly identical to the included old HTML version. . I did this XML conversion because I've been trying to renovate my Puppy Linux Setup Kit, and realized I probably need to make some really good new documentation for it, and that I could also include this old but still helpful "Some Puppy Linux Basics" page too, and maybe update it a bit. However, I really didn't want to have to do all the nice formatting, table of contents, and other navigational links manually, as I did back in 2013. So, since I've been playing around with XSLT lately, and had been thinking for a long time it might be perfect for a job like this, I began experimenting with that yesterday. . And I'm very surprised (and pleased) I managed to convert it all to XML/XSLT in less than 2 days! My XSLT 1.0 stylesheet is rather messy and hastily-coded, but with a few small exceptions, it mostly does exactly what I want. XSLT can be really frustrating and difficult, but it makes you feel like a genius when you finally get it to work. . So, now I can focus more on actually writing documentation, without spending so much time on nearly mindless chores like copying and pasting in a lot of formatting and navigation. That used to be so bothersome that it's probably one of the major reasons why I didn't update the page since April 2013. . Another former problem was, I had two slightly different versions: * A version that I included with various software I released (such as the Puppy Linux Setup Kit). * And the version on my website, which was styled to match the rest of my website, and had to have header and footer code added to it. Keeping the two in sync used to be really annoying. But now, with XSLT, I suspect handling that will be quite a lot easier, even though I haven't done that yet.