Freesite Insertion Wizard

So you've gotten Freenet Classic Opennet (FCon) installed and running. Likely one of your first thoughts is "ok, so what's next?" A fair question to which there are several answers. This page will deal with one of them . . . creating a freesite.

What's a freesite?

A freesite is a website that exists entirely within freenet. Because it is within freenet there are some distinct advantages.

No web hosting fees or domain name registrations

A freesite can essentially be as large as you want

And the big one, Anonymity, you can feel free to say anything about any subject you want without fear of reprisal or censorship.

Note that this presumes that not only are you very careful about what details you write that might identify you (such as information that could only have come from you) but that you are equally careful about your local source copies of your freesite. Keeping them encrypted on a flash drive stored in a safe place when not in use is a good idea.

There is something important to remember. You can only make static pages, No java, javascript or active scripting. These things can be used to force the web browser that you use to view freesites to reveal information about you from your IP address to your browsing history so freenet does not support them.

That said, you can make a site that you can update with new editions later on. I'm going to walk through making a simple edition based freesite and using the Freesite insertion Wizard to insert it into freenet.

Other Applications

Getting started
with Freenet

Frost - text over freenet


Freenet Utility for Queued Inserts and Downloads.

First up you'll need the Freesite Insertion Wizard which you can get here:

Like freenet, the Freesite Insertion Wizard is a java application. FiW will run in Java 1.7 or higher. This is the same java envirionment that freenet uses so if freenet will run, then so will FiW.

Setting up FiW is easy. Just extract the contents of the zip file into the directory where you want it to be and that's it.

To run FiW use the "fiw.bat" file to start it running. Before you do that though, let's get the site written first.

*NOTE* I will add a section here for how to set up your project in FiW. Though it's not difficult to figure out from the help in the program

Here's the html code for the example site *note* the front page of the site *MUST* be named "index.html" or FiW will fail

<title>:My First Freesite</title>:
<style type="text/css">:
body  {background-color: #ffffff; color:#000000; font-family:Tahoma,
Verdana, Arial, Sans-Serif; font-size:11pt; font-weight: normal; }

<p>:whatever page content you want</p>:

<p>: <img src="coolpic.jpg">:</img>:</p>:

<p>: <a href="/SSK@TEx6TiaPeszpV4AFw3ToutDb49EPAgM/mytwocents/82//">:link to a cool freesite</a>: </p>:

<p>: <a href="page2.html">:link to another page on this freesite</a>:</p>:


Ok, this is painfully simple but it's enough to show the basics. For the most part it's a basic web page with a few additions.

The first one is right after the opening head statement at the beginning of the file <hR>:<h2>:#$#pagetags-edition;</h2>:

This (case sensitive!) code tells FiW to insert some tags in the page header that freenet index spiders can use to make an entry for your freesite when they find it. The information comes from the entries you make in the FiW project for that site and it looks like this once the site is inserted:

<title>:My First Freesite</title>:
<description>:the description you enter in FiW ends up here</description>:
<activelink>:SSK@{the site's public key}PAgM/mysite/(edition number)//activelink.jpg</activelink>:
<site address>:SSK@{the site's public key}PAgM/mysite/(edition number)//</site address>:
<address type>:edition</address type>:
<edition number>:{the edition number}</edition number>:
<next edition>:{the site's public key}PAgM/mysite/(edition number+1)//</next edition
<date>:Friday,October 23,2011</date>:

The next (case sensitive!) code is this one:


This tells FiW to insert a table at the top of the page that has links to future editions of your freesite (you ARE going to write future editons right?)

example of the header added by FiW

FiW automatically fills in the correct edition numbers when it adds the header code to the page

Each link is associated with the activelink image for your site, and is trying to load it from the three future editions. If any of them load, that means that there is a more recent edition and clicking on that image will take the reader to it.

From there it's mostly just like writing any other standard html web page. The only difference is how you handle images and links.

Images that you use on your freesite should be placed in the same project directory as your index.html page. When you add them to your html code use relative addressing like so src="coolpic.jpg" without any http or leading slash.

For links to other freesites the url in the href="" part of the link code should start with /ssk@ and NOT http:// !

Remember that freenet runs on (localhost:port 8888) and the /ssk@ is actually a continuation of

Links to other pages within your freesite should, like images, use relative addressing only. The href="" should only contain the filename of the page you want to link to

*NOTE* Here I will add a walkthrough of the procedure of inserting your freesite with FiW

All that's left to do now is maybe do a couple of test pages and insert them to make sure you've got it right, then sit down and write your real freesite and insert that.

If you've any questions the best thing to do is ask on the newbie-help board on Frost. Also, once your freesite is published you should publish the key on the freesite-announce board on Frost so that people can find it.

*Note* When FiW completes the insert it will advise you to submit the site to TFE, however the author of that freesite stopped inserting it several years ago. Announcing your site and new editions on Frost boards is really the best way these days

Welcome to freenet and happy publishing!