Intro to Puppy booklet

Message

Lobster · #1 Post by **Lobster** » Fri 27 Jan 2006, 15:06

Update
Feb 2006 - no pics - rtf format - 81k
http://www.yourfilehost.com/media.php?c ... e=man8.rtf

I have been working on this 7 page Intro to Puppy

It gets people introduced to Puppy and downloading and setting up to boot from CD

I enclose it in three format:
Abiword (362k), Word Doc(467k) and HTML(328k)

It is the first time I have used Abiword in 1.0.7 and I was very impressed. Abiword was fast and stable - very good indeed. My tendency has always been to use OpenOffice - but Abiword proved fine.

I tried to output to PDF this came to 1179k and some of the images were lost. Not good.

The HTML output had the ability to embed the images. I liked the sound of that, so saved in this format - the formating is weird in this output and if you look at the source you can see the embeded image info. So I would recommend Abiword or Word Doc as truer to the original doc

I hope it is found to be useful

http://www.yourfilehost.com/media.php?c ... e=man1.abw

http://www.yourfilehost.com/media.php?c ... 36man1.doc

http://www.yourfilehost.com/media.php?c ... =man1.html

. . . Oh and if you are wondering where the "I" in Introducing went - it was me pressing delete at the wrong time in mtpaint (see the above image)

Nathan F · #2 Post by **Nathan F** » Fri 27 Jan 2006, 15:25

Very cool. I was just thinking of doing something similar for Grafpup, as someone just sent me a very nice pdf document about Grafpup in French which made me think about the fact that I have nothing similar to it in English. That's a neat trick with the embedded html images, although it looks more professional in the other formats. I'll see if I can figure a way to do a pdf conversion.

Nathan

Nathan F · #3 Post by **Nathan F** » Fri 27 Jan 2006, 15:57

How's this?
http://grafpup.com/download/docs/2536man1.pdf

Lobster · #4 Post by **Lobster** » Fri 27 Jan 2006, 17:49

That's great Nathan - did you import and export from Open Office?

I have placed the HTML online but in the slight edits or upload seem to have lost the embedded images - oh [sulk] - where'd they go?
Embedded code still seems to be there . . .

http://www.zen45800.zen.co.uk/puppy3/man1.html

#5 Post by MU » Fri 27 Jan 2006, 18:04

Mozilla and konqueror display the embedded images after I downloaded the file from yourfilehost.
Just dillo (patched) can't.
Mark

wetterau · #6 Post by **wetterau** » Fri 27 Jan 2006, 23:06

Scribus allows PDF export.

Nathan nologin · #7 Post by **Nathan nologin** » Sat 28 Jan 2006, 02:49

I was going to just exprot to postscript and then from that to pdf, but I had the same problems with images disappearing. I'm sure I could have gotten it resolved but I just went with OpenOffice and had no problems from that point.

Lobster is right about how far Abiword has come, though. I had a lot of problems with it in earlier incarnations but it seems rock solid now.

_raffy_ · #8 Post by **_raffy_** » Sat 28 Jan 2006, 03:12

Great work, Lobster - just remember to keep the images and HTML file in the same directory when you use HTML, and upload all to your server.

Lobster · #9 Post by **Lobster** » Sat 28 Jan 2006, 09:08

Thanks guys
I have added another section to the online version

http://www.zen45800.zen.co.uk/puppy5/man10page.html

"What is Linux" - it deals with command line needs
I also added the images (as non embedded) so they should be visible even from Internet Xploder

muggins · #10 Post by **muggins** » Sat 28 Jan 2006, 12:23

Lobster, another option for creating pdf copies of your html is htmldoc, which eric veenstra has provided a puplet of here:-

http://www.murga.org/~puppy/viewtopic.p ... ht=htmldoc

using on commandline with :

htmldoc --webpage -f man10page.pdf man10page.html

gives a 318k sized pdf, which i think is compareable withyour original html source of 56k + 213k of .png files.

i remember with the windows gui version you could select maximum compression for pdfs, but i'm not sure whether that's available with commandline.

Lobster · #11 Post by **Lobster** » Sat 28 Jan 2006, 12:51

Thanks muggins

I will be adding to it bit by bit - Once I have 20 pages or so, I will have a go with Scribus DTP too

muggins · #12 Post by **muggins** » Sat 28 Jan 2006, 13:16

Lobster,

I just thought i'd mention htmldoc as it offers a degree of pdf compression. using scribus to output your man10page.html as pdf, what size do you get?

actually i just had another look on the web & got this link for htmldoc:-

http://www.htmldoc.org/htmldoc.html

Chapter 8 details all the commandline options, including compression, so using this:-

htmldoc --webpage --compression=9 -f man10page.pdf man10page.html

i get a pdf of 303k. while this is only a marginal reduction in size, if you're going to produce larger docs, it could be worth considering as an option.

cheers,

ps whatever you do keep out of that pot!

Lobster · #13 Post by **Lobster** » Sat 28 Jan 2006, 14:42

I have just added another 2 pages - will upload a new version soon

- Have not tried Scribus output yet but your compression is certainly good - it is possible I can create or use smaller or even no images BUT I feel the images are very comforting and encouraging

I will have a go with Scribus - I think Nathan has a package at the Grafpup.com. I did use Scribus quickly (it was included in one version of Puppy - version 1 I think) and found it very usable.

Many thanks for your advice.

Lobster · #14 Post by **Lobster** » Sun 29 Jan 2006, 13:41

OK I have added more pages
and tried some more experiments
I tried the compressed abiword formats (they seemed to compress knocking about a third off the size but did not display)

I was also able to get more info on each page by using two columns and this format should be available on Windows, Linux and Mac

So this is my latest version with info on Linux and simple command line usage:

Rich Text Format
http://www.zen45800.zen.co.uk/puppy5/man6.rtf
(467k)

I did download Scribus and looked at it again briefly but to be honest Abiword is working out as sufficient so far . . .

As soon as more info for Puppy 2 is available I will concentrate on making the introductory manual for that

mortlocl · #15 Post by **mortlocl** » Sun 29 Jan 2006, 19:50

This is a rather good intro, Lobster.
I know you intend adding to this...but just wondered if you'd have the time to add an explaination for beginners re. the boot options at start up and the differences eg load entirely in memory vs having a pup file on HD, etc.

Its a common query I get from people I introduce puppy to....and I think it would completely round off your introduction to getting puppy up and working.

what do ya recken ?

Lobster · #16 Post by **Lobster** » Mon 30 Jan 2006, 10:37

Well a lot of this will change in Puppy 2
so I may not do it but it is a good suggestion - certainly will consider it
(truth is I only really use two of the options - so would have to educate myself first)

Thanks for the idea

mortlocl · #17 Post by **mortlocl** » Tue 31 Jan 2006, 03:43

"educate yourself first" Lobster - ratz...I was hoping you'd educate me.

One of the options is an odd looking word that has four or so letters that meant nothing to me.
(I keep meaning to do a search to find out more or just what it is refering to.)
New users ask me what it is when they see it but as yet I don't know.
(Though there must be an explaination in here somewhere.)

...but as you say in Pup2 it won't apply.

laptops
In the content of your intro Barry mentions the use of a laptop.
There is a non windows laptop that came out in the 90s..a small netbook by Psion.
Some clever chaps have got linux to work (kinda) on these. Only wish I was (or someone was) smart enough to get puppy to work on one. (The current Psion netbook pros now have windozs.)

Lobster · #18 Post by **Lobster** » Tue 31 Jan 2006, 14:42

I used to have a Psion PDA - very good it was too

Anyway - will add this info to the manual

The standard release of Puppy Linux 1.0.7 displays a boot menu with 5 options (Option 6 is hidden)
Pressing "Enter" will select the first option and speed up boot time
(see the isolinux.cfg in the CD image for each version's options):

Option 1 (or no input) Normal boot (default)
Option 2 Normal boot, no ACPI
Option 3 Ask which partition for pupxxx, no ACPI
Option 4 Run totally in ramdisk, no ACPI
Option 5 First boot, force multisession
Option 6 (uses memdisk for the kernel image) [not in the menu] (hidden)

ACPI=Advanced Configuration and Power Interface
ACPI transfers responsibility for power management to the operating system

1 Is the default
2 Use if having difficulties especially with Laptops
3 If you have several hard disk partitions you can call different pup001
to boot with different parameters
4 The first three options place a file on your hard disk called
pup001 This option runs in stealth mode. Your hard disk is not
touched, no file is created. It also means you have to enter
your keyboard, mouse and graphic details, set up your connection etc
5 Only use this if creating a CD or DVD recordable version of Puppy
tThat is data is save on CD or DVD - Further investigation required
- do not just select. You need to set up Puppy FIRST to use this option
6 Developer option

mortlocl · #19 Post by **mortlocl** » Tue 31 Jan 2006, 22:11

whacko Lobster...excellent...
...so thats what ACPI means.

Lobster · #20 Post by **Lobster** » Thu 02 Feb 2006, 07:27

I have removed the pics (smaller file for dialup users) - added the boot up info
It is now only 10 pages

Be interested if the format can be imported into MS Word

Update
Feb 2006 - no pics - rtf format - 81k
http://www.yourfilehost.com/media.php?c ... e=man8.rtf

(old)Puppy Linux Discussion Forum

(old)Puppy Linux Discussion Forum

Intro to Puppy booklet

Intro to Puppy booklet

slight edits

Great work

Good intro

boot options

dialup users