WordPress.org

1. podz
   Support Maven
   Posted 3 years ago #

   There is now documentation you can download, read offline and print ! Over at http://www.tamba2.org.uk/wordpress/docs are listed over 240 complete pages (a total of ~34meg of information) taken verbatim from Codex. You can download just those sections you need - and none that you do not.

   Before you start downloading or commenting though, please take a moment to read the information I’ve put together here: http://www.tamba2.org.uk/T2/codex-and-pdf/
   It should address what I think will be common questions.

   WordPress code isn’t static, and neither will these docs be either. It’s one thing to get everything there now, it’s going to be another to keep this project uptodate. When Codex recovers from the move, a new page for this project will be created in my User space. Any and all issues about this can be discussed there and if you want to help that’s the place to be.

   Feedback welcome.

2. jdingman
   Member
   Posted 3 years ago #

   Sweet job Podz =)

3. vkaryl
   Member
   Posted 3 years ago #

   Wow. What a job! WHAT a guy! Thanks Podz....

4. podz
   Support Maven
   Posted 3 years ago #

   Feedback time:
   How can this be improved ? Not wishlist stuff, but actually practically improved ?
   Is it design ?
   It is the fact it's a PDF ?
   Would CHM be better ?
   (HTML coding is waaaaay expensive in time)

   If you have used a downloaded PDF from the site, was it worth it ?
   Or would you rather I deleted it all and we just use Codex or pay for a book ?

5. fluideye
   Member
   Posted 3 years ago #

   podz,
   i think it's a nice resource but sure seems like there would be a lot of work updating. are you really willing to spend that much time and could you actually stay on top of it? could lead to people receiving bad (outdated) info

6. podz
   Support Maven
   Posted 3 years ago #

   Compared to the creation, updating will be a breeze :)

   Once Codex is back, I am hoping - and it is hoping - that people will help when I post the method. Ideally of course I would like this information to be free and accessible from this domain after all, it's the work of WP people that created Codex. Whether that happens will have to be seen.

   Codex has been uneditable since before I launched that page though so you can be assured that all downloads are as uptodate as it is. When it's back there will be a flurry of updates, but it'll calm down hopefully.

   And if it does get popped at (by more than have) I'll delete it.

7. fluideye
   Member
   Posted 3 years ago #

   I can give more feedback once I use your resource a little more. Just found out about it :) I know I speak for alot of people when I say, "thanks for all the hard work!"

8. podz
   Support Maven
   Posted 3 years ago #

   Thank you :)

   This is to everyone:
   I'm going to need some help with this though - the more people helping the easier the task, the more people helping the more you'll hopefully blog about it and the easier people will find information.

   I don't care where these files are hosted / who helps or of any other bits and pieces. My only concern is that information in Codex is available as freely and as widely as possible. Other formats would be great too.

   Please go download a couple of the pdf's and constructively criticise - I could do with some feedback :)

9. podz
   Support Maven
   Posted 3 years ago #

   Clicking the link below will download into your machine a zip of the Open Office 2 files that I used to create the PDF's.

   Note: Open Office 2 - it's in beta but only it can do embedded URL's in PDF's. I have no idea what other program will open them - but I do know that Notepad++ just see garbage characters.

   Open Office beta:
   http://download.openoffice.org/680/index.html
   73 meg Windows file.

   As Codex has been uneditable, it's all right up to date.

   Maybe you can think of a way to better present them ?

   All the files (4.38meg zip)

10. gutielua
    Member
    Posted 3 years ago #

    HOUSTON, WE HAVE A PROBLEM!!!

    T2

    Error 404 - Not here !

    Look like I must have deleted something eh ?
    My apologies.

    WordPress help can be found here: http://www.tamba2.org.uk/wordpress

    If it was something else you were particularly after, email me and I'll dig through whatever files I have.

    My email: tamba2 AT gmail dot com

    Tamba 2

11. podz
    Support Maven
    Posted 3 years ago #

    Sorry !
    Fixed now - I'd forgotten to switch an index file.

12. gutielua
    Member
    Posted 3 years ago #

    That's GREAT!

    One sugestion, it's posible add the version (date) of each file?

    Ex.
    Backing_Up_Your_Database.pdf [Version Date:6 August 2005]
    Before_You_Install.pdf [Version Date:6 August 2005]

    For us, will be more easy to know which file was updated, right?

13. podz
    Support Maven
    Posted 3 years ago #

    Right now, everything is pretty much 6 August.
    As the pdf's are updated, that will be reflected on the download page.

14. gutielua
    Member
    Posted 3 years ago #

    Ok, thanks for all!!

    Regards from Monterrey, MEXICO.

15. elis
    Member
    Posted 3 years ago #

    Great work! Thank you very much!!!

16. gutielua
    Member
    Posted 3 years ago #

    pods, finally i download all 244 files on pdf, buy on the zipe file of ODT Files there are 249 files. so, this are the missing 5 files on PDF...

    _template2.odt
    Template_Tags+bloginfo.odt
    Template_Tags+get_category_parents.odt
    Template_Tags+get_links_list.odt
    Template_Tags+link_pages.odt

    Regards
    @ndrés
    gutielua.com

17. podz
    Support Maven
    Posted 3 years ago #

    Why why why ........
    Within a day of Codex being back, half a dozen of those will be updated. So will you download them all again ? Did you really need 'How to Install ?' if you did, then why download the advanced stuff ?

    Thanks for the info - I'll check the file later.

18. gutielua
    Member
    Posted 3 years ago #

    just in case!

    bye!

19. amit
    Member
    Posted 3 years ago #

    That's a great job Podz, you surely rock!! :)

    CHM would ofcourse be much better than a PDF and as for HTML coding, I thought that I read somewhere about a CHM compiler that created it from Word files!! converting PDF to Word ofcourse is a piece of cake if you don't already have a Word file. :)

    If you wanna know, I'll look for that CHM compiler.

20. podz
    Support Maven
    Posted 3 years ago #

    amit - you could always do that ? :)

21. TechGnome
    Moderator
    Posted 3 years ago #

    Are CHM files cross platform though?

    -tg

22. podz
    Support Maven
    Posted 3 years ago #

    Apparently there is some sort of code that will allow it on a Linux platform (though which I do not know). Mac ? not a clue.

23. amit
    Member
    Posted 3 years ago #

    ok, I'll look for it tonight when I run into some free time!! :)

    and another thing about your bandwidth issues, WordPress had an SF account, no? If its still there, then the docs can be hosted there. Or if Matt is unable to host them on Codex, then a new account can be created on SF(though I doubt they'll allow it).

    Are CHM files cross platform though?

    Not cross-platform natively, since they are native to Windows only, but there are free softwares available so you can read them on Linux as well. I'm not aware of any such thing for Mac but possibly it'll be there as well even if I don't know of any!! ;)

    Another thing is that if we do it in a CHM format, then it'll be of lesser weight than the current PDFs, take a look at the PHP Manual in CHM format, just 4MB or so, & its quite vast!!

24. podz
    Support Maven
    Posted 3 years ago #

    Bandwidth currently is not an issue - the files are sitting in ISP space which is virtually unmetered. I have them elsewhere too (in my webspace) just in case.

    As for cross-platform, PDF's are. Yes they may be a bloated format compared to some, but the adobe format is pretty common.

    Weight - if you only download what you actually need, then weight is not a problem. The largest pdf is around ~320KB which isn't going to stress a machine. There is NO SENSE WHATSOEVER in creating one great big file - it would be utterly pointless. The fact is, if someone downloads everything they are just being daft - it's a useless activity given the updating, and it's a useless activity given that if you need the Installation help, then what are you doing getting all the stuff on template Tags ? Take what you want, when you want it. I will certainly never create one big file.

    SF Hosting ? No idea. Seems like a lot of hoops to jump through.

    Creation - has to be straightforward. As it is, anyone on any machine can grab OO and contribute. As soon as this deviates, then the number of people that could help reduces - and seeing as that number is already extremely small, it makes no sense.

    Can I suggest that further discussion on this topic be taken to the Documentation Mailing List ?

25. TechGnome
    Moderator
    Posted 3 years ago #

    You know what would be really cool? - and I'd offer to do this if I only knew how - Present the user with the list of available docs, each with a checkmark box. Then the user could click off (on?) the ones they do want. Click a button, and get a Zip file with the selected PDFs they requested. I don't know how feasable that really is, but it would make downloading the ones you want a lot easier. I imagine the Zip file being generated on the fly. I've seen it done before, I just don't know how to go about doing it.

    -tg

26. podz
    Support Maven
    Posted 3 years ago #

    And when they check them all it says "Tut tut tut, you didn't want to do thaaaaaat :) "

27. amit
    Member
    Posted 3 years ago #

    And when they check them all it says "Tut tut tut, you didn't want to do thaaaaaat :) "

    yeah, that would be uber cool, & the user would know that he's hit something sacred & needs to re-think!! ;) :P

28. jossmer
    Member
    Posted 3 years ago #

    After much hard work by Podz on producing a downloadable codex that is Clear,concise and so easy to use compared to the officle Codex. I read with dismay that It is no longer available. Why? read here http://www.tamba2.org.uk/T2/archives/2005/09/22/codex-and-pdf-i-killed-it/
    It is a crying shame...

29. duck1123
    Member
    Posted 3 years ago #

    I know you've decided to kill this off, but did you ever look into getting raw xml data from the codex and using xsl to transform it into a pdf file? It may take a little bit of work, but you could write a script that compliles a new help document at given intervals.

    There may be other factors I'm missing here.

30. podz
    Support Maven
    Posted 3 years ago #

    duck - that presupposes I have a script, that such a script has maybe more access to raw data, and this issue was talked about on the docs list and at #meetup. But thats all that did happen - talk. And talk doesn't update docs. I asked for support and help. I got none.... that's the way it goes sometimes.

Topic Closed

This topic has been closed to new replies.