[ SDF Public Access UNIX System .. Est. 1987 ]
join welcome faq status members projects store tour gopher abuse dialup
nihongo chinese europa usermap webmail forum gallery elearn irc tutorials software telnet ssh
Tutorial for Editing Tutorials
This tutorial has been introduced to help members to more easily contribute to the SDF Tutorials project.
The SDF Tutorials utilize simple RCS. 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
README.TXT (which can also be found on
the shell at /sys/html/tutorials/README.TXT).
Creating a New Tutorial
- cd /sys/html/tutorials
- touch new_filename.html
- chmod a+r filename.html
- ci -u new_filename.html (and then follow "Editing or Modifying an Existing Tutorial")
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 an Existing Tutorial
- cd /sys/html/tutorials
- co -l filename.html (checks out the file and locks it while you make your edits)
- nano (or vi or pico or whatever to make your edits) filename.html
- ci -u filename.html (checks the file back in and unlocks it so the next user may edit, make a log entry if desired as indicated)
Tips
- 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 that goes between the
<BODY> and </BODY> tags, for example, the title of your
tutorial, the tutorial text, and the RCS $Id$ tag. You can use the
following as a template:
<h1>TITLE</h1>
TUTORIAL-TEXT-WITH-HTML-MARKUP
<hr>
$Id$
|
- For some basic html editing tags, you can view this html page's source.
Contributors
- Thanks to wa5pb. Parts of this were yanked from his post on the SDFARC forum.
- Thanks to admins responding to email/forums with proper advice.
- Thanks to me, rogerx, for taking my time providing this page for members.
$Id: tutorial_editing.html,v 1.14 2010/07/28 05:02:13 nerfling Exp $
©1987-2010 SDF Public Access UNIX System, Inc. 501(c)(7)
(this page was generated using ksh, sed and awk)