Little Tutorial for Gallery uploaders...
|
valiant
Joined: 2003-01-04
Posts: 32509 |
Posted: Tue, 2003-05-27 15:55
|
|
I've written a little Gallery Upload Tutorial for some friends which don't know how to batch-convert / resize lots of pictures and upload them with Gallery Remote all at once. http://www.nei.ch/articles/gallery_tutorial/ cheers - Andy |
|
Posts: 3474
Cool cool cool!
I love clear, useful documentation!
Someone should add a link in the User Guide...
Posts: 32509
ah, didn't know that an end user howto already existed.
http://gallery.menalto.com/modules.php?op=modload&name=phpWiki&file=index&pagename=Basic%20Album%20Setup%20and%20Use
covers almost the same. one should update the gallery remote part of the howto as it changed a little bit since the creation of the guide and add some ''why resize before upload' and batch-resize info.
and as the end user guide grows, you certainly need a little index on the subsections (at least a few anchors).
Posts: 3474
Can I co-opt you into fixing that doc? Just grab the text from below, make the necessary changes, and e-mail it back to me? We'll give you credit on the page.
Here's the original Wiki code for that page:
http://www.beckettmw.com/downloads/wiki.txt
(Wiki Docs are here, if you need them)
-Beckett (
)
Posts: 32509
ok, gonna do that.
i've read some articles about wiki in the last few weeks, but I never edited one.
I know the normal KeyWordInCapitals style for normal links, but how do I do anchors within a single wiki document?
in HTML I'd set the anchor by <a name="anchor_name"></a> and link to it with <a href="#anchor_name">link text</a>.
cheers - andy
Posts: 3474
I think our version of phpWiki doesn't do anchors.
Can you manage w/out?
You can test out the Wiki code in the WikiWikiSandbox.
-Beckett (
)
Posts: 32509
no way!
lol, maybe i can do it without anchors, but it's not userfriendly.
if i was looking for help / a howto, I need a search function if the docu is too big or at least a good hierarchie and an index.
if you want the whole basic end user documentation within a single HTML document, anchors are a must, don't you think?
i can do a little list of all covered tasks at the top of the page and each task mark with a huge title...
bottom line:
what about splitting the basic end user guide into several HTML documents?
1. Basic Album Setup and Use (covering login, settings (preferences) and other customizing)
2. Uploading Images (covering normal and Gallery Remote upload, why resize and batch conversion)
3. Maintaining your Album (covering online image manipulation, moving, deleting images, comments and the like)
But didn't bharat mention that someone is already documenting G2? Doesn't she cover end user documentation and how different would that docu be for Gallery 1.3?
Posts: 3474
Sorry about the anchors.
We're already documenting G1 and G2.
We're using DocBook, which has anchors—and much, much more. ;);)
We also haven't written or migrated much of what's already in the Wiki... in other words there's *tons* of work to be done.
Would you be interested in joining the docs team? E-mail me if so.
I'll get you up and running, but you should still just write on the sections you want to write. (We want you to help, but not to be bored!)
-Beckett (
)
Posts: 8194
We also like to talk on #gallery on FreeNode (irc.freenode.net), if you want to come by and chat
Posts: 32509
actually, I'm hesitating. i have a lot to do for my studies at the moment, but i could do this small part for the end user documentation, nothing more, at the moment...
have you some sample docs of Gallery as DocBook or what do expect from me?
Posts: 8194
The docs in their current state can be seen in CVS here (XML):
http://cvs.sf.net/cgi-bin/viewcvs.cgi/gallery/docs
The generated docs can be seen here:
http://gallery.sf.net/docs.php
Posts: 32509
thanks joxoflinux.
gonna take a deeper look this weekend.
this can't be a coincidence, my father runs a firm doing technical documentations since 20 years and has developed a (commercial)software (requires ms word) to create technical documents (i.e. manuals) in a very efficient manner.
however, whenever i feel like documenting, i'll try to contribute a little bit.
cheers - andy
Posts: 32509
i'm setting up my windows to be able to create pages for docbook.
i'm installing lots of libs and tools as described in http://supportweb.cs.bham.ac.uk/documentation/tutorials/docsystem/build/tutorials/docbooksys/segmentedhtml/pt01.html .
is there no easier way? an all in one program. don't i just need:
- something like an editor (i.e. emacs)
- something like an xml compiler
see, i don't know xml, read several times about its definitions, xslt and so on, but isn't there a easy way?
Posts: 3474
Well... you're welcome to write the XML and send it to us and we'll add it in for you.
In fact... it doesn't even need to be XML... but it would save us some time.
We just need content to be written somehow!
So send us whatever you can! ;)
Posts: 32509
right, but i'm interested in docbook.
is there an easy way to get all necessary libs/progs on my machine? as i said, a all in one package would be nice