====== Creating and editing tutorials ====== [[#Introduction|Introduction]][[#Creating a New Tutorial|Creating a New Tutorial]][[#Editing or modifying a tutorial|Editing or modifying a tutorial]][[#Tips|HTML format guidelines]][[#Template|Template]][[#Title|Title]][[#Header|Header]][[#Body|Body]][[#Note|Note]][[#Code|Code]][[#Reference|Reference]][[#Tables|Tables]][[#List|List]][[#Links|Links]][[#Using images|Using images]][[#Using references|Using references]][[#Example|Example]] Introduction]] This tutorial has been introduced to help members to more easily contribute to \\ the [[http://sdf.org/?tutorials|SDF Tutorials]] project. The SDF Tutorials utilize simple RCS Revision Control System. \\ The only downside is initially finding the folder location and reading the lengthy \\ README.TXT. By using this tutorial, you should be able to get started much quicker! \\ Please note, this tutorial is not meant to replace the main README.TXT and reading the main \\ README.TXT will provide a better understanding. More in-depth instructions for editing SDF \\ Tutorials can be found within the [[/tutorials/README.TXT|README.TXT]] (which can also be found on the shell at \\ /sys/html/tutorials/README.TXT).\\ ==== Creating a New Tutorial ==== Change your current directory to the tutorials directory. \\ cd /sys/html/tutorials Create an empty html file with a name of your choosing. \\ touch new_filename.html Change the permissions on the file so everyone can read it. \\ chmod a+r filename.html Check the file in and unlock it so everyone can edit it. \\ ci -u new_filename.html \\ Check to make sure file permissions are retained by RCS on check-out (co).\\ If they are not, and the permissions only show user readable still, \\ then chmod a+r RCS/filename.html,v directly so that the file can be read by readers of the webpage.\\ Next, edit the main index.html page to include the newly created file.\\ ==== Editing or modifying a tutorial ==== Change your current directory to the tutorials directory. \\ cd /sys/html/tutorials Check out the file and lock it while you make your edits \\ co -l filename.html Edit the file using a text editor(i.e. vi, pico, nano) \\ nano filename.html Check the file in and unlock it so everyone can edit it. \\ ci -u new_filename.html ==== HTML format guidelines ==== Whether after issuing the co command or simply editing a file within /sys/html/tutorials, \\ modifications can be viewed in real time with a browser over the internet. But remember, \\ changes will only be saved if you use co/ci properly! The tutorial server script generates \\ the page header and footer, so you only need to supply the content of the tutorial you plan to \\ post and the RCS $Id$ tag. You can use the following as a template:\\ \\ YOUR CODE HERE\\
\\ $Id$\\ \\ This is how to to define a comment\\ \\ This is the code to define a tutorial title\\ \\ \\

Here is a test for the title format.

This is the code to define a tutorial header\\ \\ \\ This is the code to define a tutorial body.\\ \\ \\

Here is a test for the tutorial body format.

This is the code to define a tutorial note section.\\ \\ \\

Here is a test for a note/warning/tip.

This is the code to define a tutorial code section.\\ \\ \\

Here is a test for the code format.

This is the code to define a tutorial reference section.\\ \\ \\

Here is a test for the reference format.

This is the code to define a table.\\ \\

Table Header 0	Table Header 1	Table Header 2
Table DATA	TABLE DATA	TABLE DATA
Table DATA	TABLE DATA	TABLE DATA
Table DATA	TABLE DATA	TABLE DATA

This is the code to define a list. You have have two levels: the title of a section(dt) and the subsection(dd). \\

Section 1: Section 1.1; Section 1.2; Section 1.3
Section 2: Section 2.1
Section 3: Section 3.1; Section 3.2
Section 4: Section 4.1; Section 4.2

This is the code to define a link. \\ Example link \\ ==== Using images ==== No hotlinking of files from other sites: images must be uploaded to the /sys/html/tutorials/images folderWhen using images tags must be clearly defined.\\ Incorrect\\ \\

\\ Correct\\ \\ Example

\\ \\ ==== Using references ==== Book: Author's last name, first initial. (Publication date). Book title. Additional information. City of publication: Publishing company. Encyclopedia & Dictionary: Author's last name, first initial. (Date). Title of Article. Title of Encyclopedia (Volume, pages). City of publication: Publishing company. Magazine & Newspaper Articles: Author's last name, first initial. (Publication date). Article title. Periodical title, volume number(issue number if available), inclusive pages. Online periodical: Author's name. (Date of publication). Title of article. Title of Periodical, volume number, Retrieved month day, year, from full URL Online document: Author's name. (Date of publication). Title of work. Retrieved month day, year, from full URL \\ ==== Example ==== Here is the [[http://sdf.org/?tutorials/example|example]] and [[http://sdf.org/?tutorials/example_source|source]] of a typical tutorial. $Id: format.html,v 1.17 2014/09/11 09:30:24 grobe0ba Exp $

Here is a test for the title format.

Here is a test for the header format.