I’m not sure if i’m talking out of place at all, so just hear me out…
I’ve been a newbie reading the SDL mailing list for about a year now, but never
been a frequent poster. What really helped in my development/hobby fiddling was
the SDL document project that had been setup.
Now to get to where i’m going…
Since just before this topic had come up, i’d been playing with using a Wiki*,
and had setup a basic system.
Over Christmas, I decided that since SDLdoc is loosing it’s manager, needs
updating, and requires an easier system to add the content; I started converting
some of the SDLdoc pages into Wiki, and modding the wiki system to accept the
requirements I wanted.
I’d tried contacting the current SDLdoc maintainer, but hadn’t had much luck, so
continued to do the odd bit every day.
It’s currently up at http://www.nextraweb.com/cgi-bin/SDLdoc
Have a look, have a comment, have a mock.
It is current open to abuse, so I ask that people be careful editing pages, but
just in case, I can revert to older copies
Does anyone have a problem with me taking over the doc project?, does anyone
want to help manage the site if we do?
Would people like to help populate the content, add more examples, or even help
adjust the UseMod code to our specific usages.
A Wiki, for those of you that dont know, is a freeform website.
Anyone can creat pages, edit pages, format pages. It doesnt use HTML, but a very
simple set of rules to format a page, you’ll learn in a few minutes …
[Currently my isp’s webserver is having an upgrade, so please excuse the odd
Gaetan de Menten wrote:> On Mon, 2004-02-09 at 22:27, Florian Hufsky wrote:
i don’t know if this has been discussed any further (i’ve seen nothing).
No. Or well… Nothing that I’m aware of anyway. Back then, I tried to
contact Martin Donlon to ask him if he agreed to let me do the port and
to get some information on how the SDL doc project currently works but
never got any answer.
so how’s the plan now?
I currently don’t have the time to do it on my own anymore, but if
someone volonteer for the job, I’ll gladly help with some code and/or
explanation on how SDL site works, if needed.
will the sdl doc be ported to the sdl main site?
I don’t know. I’d like it to be so, but…
do you need some one to do this?
I guess so, but I’d like to have some news from Martin Donlon too, since
I guess it would help the port quite a lot…
what’s there to be done?
If it’s to be migrated to the main site, here is how I would do it:
define new tables in the SQL database to store the pages (possibly
reusing the current table definition if the current pages are stored in
a SQL database – which I don’t know). Alternatively, we could "store"
the pages as html outside the database but, although this would probably
lead to faster page generation, I don’t like the idea since it would
reduce the possibilities.
add Doc Project related privileges in the main site privilege table.
write the PHP code (possibily only adapting the old code) to
show/edit/add the documentation pages.
insert the actual content into the new system by hand, or, preferably,
using automated tools (if possible).
Sam Lantinga wrote:
On Tue, 2003-12-09 at 03:08, Sam Lantinga wrote:
Sam, you never told us your opinion on this topic, and I’d like to know
what you think…
SDLDoc maintainers… and the fact I’d like to include SDL doc on the
I like it, if it can be migrated over without too much hassle.
Martin, do you know what it would take to move the SDLdoc website
over to libsdl.org?
SDL mailing list
SDL at libsdl.org
-------------- next part --------------
A non-text attachment was scrubbed…
Name: not available
Size: 250 bytes
Desc: not available