Welcome Guest, Not a member yet? Register   Sign In
Documentation in .pdf format
#1

[eluser]StormStrikes[/eluser]
Hello everyone. I went to the user guide section and ultimately printed out everything there which took some time and left me with about a 500 page manual it seems.

Ive never been a fan of the trend of online documentation and foregoing portable formats such as .pdf, .doc and so forth. I just dont like having to read a web page at the same time Im trying to learn about something like CI. At any rate, with that said, is there a .pdf version of the user guide? Something I can download and save to a memory stick or do a double sided print out of? Thanks.
#2

[eluser]Michael Wales[/eluser]
Sounds like a fun project actually.

Derek,
Does EllisLabs have any issues with someone screen-scraping the User Guide for this effort? Shouldn't be difficult at all to screen-scrape and dynamically generate a PDF.
#3

[eluser]StormStrikes[/eluser]
Thats what I was thinking. Ive done that before for my own personal use, but I wouldnt do it and post it up somewhere without an okay to do so.

It wont be difficult, but it will take some time, but I dont mind giving it a stab.
#4

[eluser]Derek Allard[/eluser]
As long as you're using the manual for CodeIgniter support, we have absolutely no issues with converting it into PDF. Go nuts! And feel free to make it available to the community. One thing to keep in mind though is that with each new release of CI the userguide may change. This is almost always corrections or typo fixes, or to document new functions... nothing major - but it would involve going back through the process again at a later date.
#5

[eluser]StormStrikes[/eluser]
Understood. But not having to flip between webpages or wikis would be worth it to me anyway.

I can only imagine being in a classroom today and the students having to click through web pages as the instructor goes through the material as opposed to having a book and being able to at least book mark pages. Call me old fashioned but I like being able to scribble in the margins and take notes and so forth...LOL

I dont know how long it will take, but I'll give it a try and post it up once I have it done.
#6

[eluser]Michael Wales[/eluser]
I was just going to write a Ruby script to knock it out real quick... run it each time there is an update to the documentation and bam - brand new PDF.
#7

[eluser]StormStrikes[/eluser]
Well that would save a ton of labor. Geesh I need to learn some of these programming scripts.
#8

[eluser]Derek Jones[/eluser]
walesmd, so long as you are doing this on the copy of the user guide on your own installation, it's no problem. I think our server admin would frown on scraping from CodeIgniter.com though. Wink
#9

[eluser]Michael Wales[/eluser]
Yeah - I didn't even think of using my own local copy. That's probably the route that will be taken.
#10

[eluser]StormStrikes[/eluser]
walesmd, just checking, but are you going to try and use your process to create a .pdf? If not, I can go through and start doing so manually. Just asking because there's no need in duplicating the work, plus if you can create a script that easily you'd be sitting back relaxing having a drink or something before I finished the first page.




Theme © iAndrew 2016 - Forum software by © MyBB