====== MetaARPA Tutorial Template ====== SDF [[http://www.sdf.org/?tutorials|MetaARPA tutorials]] are a valuable source for learning about computing technology available on SDF, and an important way for MetaARPA members to help build-up the SDF community. I have contributed to more than one of the tutorials. One reason I haven't contributed more is the need to remember the fine details about how the tutorial documents are prepared and stored (directory, permissions, revision control ...) oftens extinguishes my enthusiasm for the subject under consideration. The [[http://sdf.org/?tutorials/tutorial_editing|tutorial editing tutorial]] is a great help for that problem, but being a stickler for technical details, I found myself wasting a lot of time during the writing of my latest contribution to worrying about HTML formatting, compatibility with other tutorials, considering old templates. I resolved to do the community and myself a favor by coming up with a sure-fire tutorial template and make it available for everyone. Poking around a little, it turns out the problem is a lot simpler than I thought. The main point of an HTML template would be to standardize the hard-to-remember hocus-pocus tags that are concentrated in the document header that define the document type, character set, style sheed, .... It turns out that there's no need to specify any of that in a tutorial document. The tutorial server script slaps a header and footer on each tutorial document before returning it to the client browser that includes the entire HTML header, the BODY start and end tags, and the site title and navigation section at the top of each page. Therefore, the tutorial writer is only responsible for providing the content between the and tags, with an $Id$ tag at the end for the revision control system. The template I came up with below is almost too simplistic to be worth sharing, but I think having it layed out in black-and-white will help fellow MetaARPA members to stop worrying and boldly write that next tutorial. I intend to add this template as a proposal in the tutorial editing tutorial.

TITLE

TUTORIAL-TEXT-WITH-HTML-MARKUP $Id$ UPDATE: Done 2010/6/8 {{tag>sdf tutorial}} Category: [[sdf:]] ~~LINKBACK~~ ~~DISCUSSION~~