ROCK Linux People Homepages

Pages

Getting a Homepage on this server

Every ROCK Linux developer can create a homepage here for ROCK Linux
related content and a small presentation of himself.


1. Getting started
==================

If you don't have allready an rsync account for maintaining a personal
directory at http://www.rocklinux.org/people/, ask me (clifford@clifford.at)
for one.

When you have an account-name and a password, you need to create a "master
directory" on your workstation and download the maintain script:

  ~$ mkdir my-rock-dir
  ~$ cd my-rock-dir
  ~/my-rock-dir$ wget http://www.rocklinux.net/people/maintain.sh
  ~/my-rock-dir$ chmod +x maintain.sh

Now you need to download the data which is currently in you directory on the
ROCK Linux server:

  ~/my-rock-dir$ ./maintain.sh down <user-name>

After you made a change you can upload you changes with:

  ~/my-rock-dir$ ./maintain.sh up <user-name>

It's recommended to use the script instead of using rsync directly.

You diskspace on the web-sever is very limited and we don't have much
bandwith on our connection. So please don't upload huge things like
CD-Images etc.


2. Rock.sed
===========

The *.html files on www.rocklinux.org are rendered from *.in files using a sed
script. That makes it easier to embed the complex layout templates used by our
webpage. So - if you want to create *.html files without using the sed script, 
you have two possibilities:

 1.) Simply save it as .in files but don't use our layout templates. That's
     the _recommended_ way to do it!

 2.) Save it as .html and don't create a .in file. That's _not_recommended_
     since the maintain.sh script will remove all *.html files before
     re-creating them from the *.in files.

The 'maintain.sh' script automatically re-creates the .html files when started
in 'up' mode. So you don't need to care about the sed invocation.

The most importand template tags used in the .in files are:

  <ROCK Title> .................... Should be the first line of every .in file.
                                    'Title' will be the text displayed in the
                                    title bar of the browser window. This tag
                                    will create the entire HTML header
                                    including the <BODY> tag.

  </ROCK> ......................... Should be the last line of every .in file.
                                    It will create </BODY> and </HTML> tags.

  <ROCK-TITLE-2 Up Title> ......... This will create the title and nav-bar at
                                    the top of the HTML page. 'Up' is the href
                                    value of the up-button, normally '..'.

  <BIGBOX>  </BIGBOX> ............. The big red box.

  <TEXTBOX Title>  </TEXTBOX> ..... On of this white boxes with black frame and
                                    black title bar. Use <P> Tags between two
                                    Textboxes.

  <FOOTER Year Name URL> .......... The info seen at the end of each page.
                                    'Year' is the year used in the Copyright
                                    info. 'Name' is the name of the author
                                    (use   istead of blanks here) and
                                    'URL' is the url for the author. This can
                                    be his/her homepage or a 'mailto:' link.

Have a look at the sed script (http://www.rocklinux.org/rock.sed) and the
existing .in files for details.