A Freesite Indexing System Using Page Tags
Page Written by S.C.U.M. Last Edited:Saturday, May 24, 2003
Introduction
Why?
Step-by-Step Guide
Notes FAQ

Introduction: The system described here is currently being used by the TFEE Freesite Index.


Why?: By placing these tags on your page you will help Freesite Indexes/Directories to gather the correct information about your page and will allow you to make available information that would otherwise be impossible to provide without directly contacting the operator of the Index/Directory.


Step-by-Step guide for adding information tags to your Freesite:

Step 1.

Select the entire text in the box below by dragging the cursor over it, then copy it, usually [Ctrl-C] or [right-click and choose 'Copy'] .
Note: There is no space between "<!--" and "index".

<!--index
<title></title> SITE TITLE
<category></category> INDEX CATEGORY
<description></description> SITE DESCRIPTION
<activelink></activelink> ACTIVELINK FILENAME OR KEY
<site address></site address> URI ADDRESS
<address type></address type> DBR / EDITION / ONE SHOT
<edition number></edition number> EDITION NUMBER FOR EDITION SITES
<next edition></next edition> THE FULL SSK@ OF THE NEXT EDITION OF AN EDITION FREESITE
<author></author> AUTHORS NAME
<date></date> INSERT DATE
<no indexing></no indexing> INDEXED BY DEFAULT(NO) PUT YES FOR NO INDEXING
-->

Step 2.

Open your freesite page in a text editor (like Notepad) or choose 'source' in your WYSIWYG page editor

Step 3.

Paste the copied text into your Freesite page source. Although it can be put anywhere in the document, the best place is in the <HEAD> section so that it will be processed faster. the INSTRUCTION parts may be left or removed they will not effect your information tags, a template without instructions is available under Notes Example:

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<title>The Greatest Freesite Ever Made</title>

<!--index
<title></title> SITE TITLE
<category></category> INDEX CATEGORY
<description></description> SITE DESCRIPTION
<activelink></activelink> ACTIVELINK FILENAME OR KEY
<site address></site address> URI ADDRESS
<address type></address type> DBR / EDITION / ONE SHOT
<edition number></edition number> EDITION NUMBER FOR EDITION SITES
<next edition></next edition> THE FULL SSK@ OF THE NEXT EDITION OF AN EDITION FREESITE
<author></author> AUTHORS NAME
<date></date> INSERT DATE
<no indexing></no indexing> INDEXED BY DEFAULT(NO) PUT YES FOR NO INDEXING
-->


</head>

<body>...

Step 4.

Enter you page information between the information tags. The tags are structured like HTML tags, each information element has an opening tag (<tag>) your information and then a closing tag (</tag>). Indexes may or may not use all the information you provide. Tags are not case sensitive, <TiTlE> and <title> are equal, a more detailed explanation of individual information tags is HERE. At this time spaces should be avoided in tags except where called for.
<   title  > is bad
<title> is good
<next edition> is good, a space is called for between next and edition

Tag Example:

<description>This is the Greatest Freesite ever</description>

These information tags are flexible, you may fill-in and include whichever ones you wish, you may also put them in any order, the tags must lie within <!--index TAGS HERE --> here are some usable examples:

<!--index
<date>June 10 2003</date>
<description>A site about my cat Fred</description>
-->


<!--index <title>Crazy Page</title><author>Da' Nut</author><activelink>yayaya.png</activelink> -->

<!--index
<title>Enron Executives Exposed</title>
<category>Information</category>
<author>WhistleBlower</author>
<description>I have exclusive information on Where Enron executive's hidden bank accounts are located. It's all here.</description>
<activelink>activelink.jpg</activelink>
<edition number>1</edition number>
<email>enronexposed@hushmail.com</email>
-->

In the last example the author has included a new tag that is not currently used <email></email>. You can create your own information tags using the <tag></tag> format and indexes may decide to use them. Any new tags have a better chance of being used if you announce your new tags on Index site NIM's, IIP, Frost etc.



Notes

Here is an information tags template without instructions:
<!--index
<title></title>
<category></category>
<description></description>
<activelink></activelink>
<site address></site address>
<address type></address type>
<edition number></edition number>
<next edition></next edition>
<author></author>
<date></date>
<no indexing></no indexing>
-->

This is more detailed description of the intended use of individual tags:
<!--index This identifies the beginning of your Information tags within your page, it must be present for your information to be identified
<title></title> This is the title you would like for the page
<category></category> This is a category you would describe your site as, this is best kept simple like 'Blog', 'Software', 'Website Mirror' etc.
<description></description> This is the description you want shown for your site, indexes generally use only the first 200-250 characters, so be fairly brief, looking at other descriptions will give you an idea of what works best
<activelink></activelink> This can be either the filename of your activelink picture (activelink.png) or the Freenet address of your activelink
(SSK@-w495UL3mfSlWC2c~nRAuG2fAWwPAgM/TFEE//activelink.png)
<site address></site address> This is the SSK address of your site
(SSK@-w495UL3mfSlWC2c~nRAuG2fAWwPAgM/TFEE//)
<address type></address type> This is the type of Freesite address,
DBR - This is the date specific site, these sites are usually inserted daily
edition - Edition sites are usually numbered (1,2,3...)and do not have to be inserted daily, a new version is published under the next highest number
one shot - This is a one version freesite, it is not meant to have future editions.
<edition number></edition number> This is the current edition number of an edition Freesite. You can have FIW automatically fill this in for you by selecting "parse index.html" in your site's settings and putting #$#ps.ednum; between the tags
<next edition></next edition> This is the address of the next version of an edition Freesite, You can calculate this by taking your current Freesite address and substituting the edition portion with your next intended edition
Current:SSK@VsrxOrk7nxAvemqX4n368yoYOCwPAgM/scum/1//
Next:SSK@VsrxOrk7nxAvemqX4n368yoYOCwPAgM/scum/2//

You can have FIW automatically fill this in for you by selecting "parse index.html" in your site's settings and putting #$#e:ps.ednum+1; at the spot where your edition number is located, example:
SSK@VsrxOrk7nxAvemqX4n368yoYOCwPAgM/scum/#$#e:ps.ednum+1;//

<author></author> Author's name, on Freenet this would usually be a nickname, like "fillament"
<date></date> This is the insertion date for your site, You can have FIW automatically fill this in for you by selecting "parse index.html" in your site's settings and putting #$#date:EEEEEEEE,MMMMMMMM dd,yyyy; between the tags
<no indexing></no indexing> By adding yes here you will ask that the page not be indexed, this does not prevent indexing of your page but it might be usefull to include this on a test page, navigation frame page, temorary page etc.
--> This identifies the end of your information tags, careful, if you leave out this tag your page might not display properly.

Here is a glossary of terms
Freesite - A term commonly used for a Website on Freenet
Tags - Inline language commands, commonly used in reference to HTML, example <BODY> is an HTML "tag"
WYSIWYG - A type of HTML editor that allows you to edit the page as it will look in it's published form, Information tags must be placed in the Source of the page, not the WYSIWYG window.
HTML - This is the language of web pages, the tags are the elements of HTML
Activelink - This is a small picture inserted with your site to represent it in links, they are commonly 95x32 pixels and named activelink.ext (ext being png,gif or jpg) but most sites will accept any size and scale it to 95x32

How to Identify a CHK@ or other non-mapfile key as a Freesite
It is extremely difficult for an index to identify a key without a mapfile as a Freesite. If you insert a non-mapfile key and want to identify it, you can use the 'no indexing' tag and add NO to request it be indexed as a Freesite, example:

<!--index
<no indexing>NO</no indexing>
-->


FAQ

This is a very brief FAQ because this page was just written and there are no questions.