Most recent edit on 2008-10-02 02:42:21 by Luke771 [merged with my jSite page [[jSite]]]
Additions:
jSite
A Freesite uploading tool
develped by by Bombe
What is jSite
jSite is a tool that you can use to insert freesites into the Freenet distributed storage.
Creating a freesite is done in two steps, first you build a website in HTML, then you upload your creation to Freenet. That's when jSite comes into the picture: with a nice user-friendly point-and-click interface and five languages to choose from, uploading freesites couldn't be easier.
jSite is written in Java; it will run on any java-enabled operating system, no need for Windows versions, Mac versions, etc: one file fits all - and that file is jSite.jar
Getting jSite
You can the latest version from the official Freenet website:
http://downloads.freenetproject.org/alpha/jSite/jSite.jar∞
Using jSite
First and foremost, jSite requires Java 1.5 or better and a Freenet node installed and running.
Howto Page
Learn how to use jSite at the jSite Howto page with Screenhots
Quick Howto
Some Theory
not much, I promise
A word about keys
No need to go into the details of Freenet keys here. Basically you need a key to get a file from Freenet, including html files that freesites are made of.
When you insert a freesite, jSite generates both a public and a private key for your site.
The public key is "the key to the site" that you announce on FMS and other Freenet users paste into their browsers to visit your freesite.
The private key is stored on your computer. jSite uses it when you update your freesite, which means that if you lose the directory where jSite stores its data, you won't be able to update your freesite(s). Therefore, you don't want to lose the jSite data directory. Back it up and back up the back-up
So back the f* up!
As we have seen, you definitely want to back up the jSite application data folder.
Remember to update your back-up often, ideally every time you update a freesite.
Windows users
On Windows, jSite data is stored in
C:\documents and settings\<user>\application data\.jSite
where <user> is your user name.
NOTE - Windows hides 'Application Data' folders by default: you may have to change the settings in Windows Explorer.
Real OS's users
If your operating system is Unix-based (that includes Ubuntu∞ and any other Linux∞ distribution, plus another bunch of operating systems) the folder you want to back up is:
/home/<user>/.jSite
where <user> is your user name
NOTE: on Unix-based systems, folders with a dot at the beginning of the name are invisible by default. Enable 'show invisible files' in order to see them
(editing needed, here!) => Mac OSX and the whole Mac family are also Unix-based: I guess the jSite app data may be in /home/user/.jSite <= (editing needed)
Now what?
So far, we have downloaded jSite, we have learned that we can use it to upload freesites into the Freenet distributed storage, and also that it is important to back up a folder called .jSite. Now what?
Now you're ready to try and insert your first freesite:
Click HERE to go to the jSite Howto Page
Deletions:
jSite is a graphical application that you can use to create, insert and manage your own Freenet sites. It was written in Java by Bombe. It comes packaged with the Freenet installer, so it should be in your main Freenet directory.
Using jSite
First and foremost, jSite requires Java 1.5 or better.
Edited on 2008-05-06 01:12:28 by XtremeWays [Minor typo]
Additions:
Troubleshooting
Deletions:
Troubleshooting
Edited on 2008-05-06 01:11:45 by XtremeWays [Added description of command line options, and --debug]
Additions:
Troubleshooting
If something goes wrong, jSite often displays a very generic error message:
"Insert failed. The insert of the project failed. Some files could not be inserted"
The best way to troubleshoot jSite is to run it with --debug option, as follows:
$ java -jar jSite.jar --debug
Debug message often describe the exact error that happened.
Command line options
jSite has a few command line options that can be seen by using --help option:
$ java -jar jSite.jar --help
--help shows this cruft
--debug enables some debug output
The important in practice is debug option.
Edited on 2007-09-23 18:22:15 by NogaSo [Removed the links to the freesites as they were pre-1010]
Deletions:
See also
These are Freenet 0.7 links, so you need Freenet running to use them:
- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
- Niky's Home∞ another guide to inserting a page to Freenet using jSite.
Edited on 2007-07-31 16:29:35 by TehAmI [jSite gives USKs]
Additions:
~- To see the site you just added to Freenet, press the Copy URI to Clipboard button above the site details. Open your browser, enter the address of your node (e.g. http://localhost:8888/∞) and paste the key directly after the final "/". It should look something like this: http://localhost:8888/USK@fgh6yZ...BABAA/mysite/1/. It it does, press Enter and your node will try to retrieve the page from Freenet and displays it.
Deletions:
~- To see the site you just added to Freenet, press the Copy URI to Clipboard button above the site details. Open your browser, enter the address of your node (e.g. http://localhost:8888/∞) and paste the key directly after the final "/". It should look something like this: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/. It it does, press Enter and your node will try to retrieve the page from Freenet and displays it.
Edited on 2007-02-14 01:02:28 by ShoeyFighter [Changed some text]
Additions:
jSite is a graphical application that you can use to create, insert and manage your own Freenet sites. It was written in Java by Bombe. It comes packaged with the Freenet installer, so it should be in your main Freenet directory.
Using jSite
First and foremost, jSite requires Java 1.5 or better.
Run the application by typing this at the command line:
See also
Deletions:
jSite
jSite is a graphical application that you can use to create, insert and manage your own Freenet sites. It was written in Java by Bombe. You can download it from here: http://downloads.freenetproject.org/alpha/jSite/∞.
Download the jSite.jar∞ file and store it somewhere (in your Freenet installation directory maybe?).
Run the application by typing this at the command line (Note: You must be running java 1.5 or better):
See also
Edited on 2006-09-01 18:08:42 by BombeQ [Update documentation a bit.]
Additions:
~- The "Freesite:" line you can see on this window will be part of the address of your new site, but don't worry, you can get this from the main Select a Project windows as well. The "Copy URI to Clipboard" button that is disabled when you start inserting will be enabled as soon as the node determines the final address of the site.
- When the insert has finished, you will get a message pop up telling you that the project has been inserted successfully. Click Copy URI to Clipboard to copy the final URI of your site to the clipboard so you can paste it easily to wherever you need it. Pressing Next on the Project Insert window will take you back to the first Select a Project window.
- To see the site you just added to Freenet, press the Copy URI to Clipboard button above the site details. Open your browser, enter the address of your node (e.g. http://localhost:8888/∞) and paste the key directly after the final "/". It should look something like this: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/. It it does, press Enter and your node will try to retrieve the page from Freenet and displays it.
Deletions:
~~- Edition - this should be automatically set to the next version that is to be inserted.
The "Freesite:" line you can see on this window will be part of the address of your new site, but don't worry, you can get this from the main Select a Project windows as well.
When the insert has finished, you will get a message pop up telling you that the project has been inserted successfully. Click OK to this message, and then Next on the Project Insert window.
This will take you back to the first Select a Project window.
- To see the site you just added to Freenet, you need to construct the address of the site (the URL) as follows:
- The first part is http://localhost:8888/
- Then add the contents of the Request URI field: freenet:SSK@fgh6yZ...BABAA/ (the freenet: is actually optional).
- Then add the contents of the Path field, followed by a dash: mysite-
- Then add the contents of the Edition field, less one. So if it is 2, put 1
- Finally, put a / at the end.
- So putting it all together, you should have something like: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/
Edited on 2006-08-04 01:26:38 by HotTuna
Additions:
~- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
Deletions:
~- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
Edited on 2006-08-04 01:16:12 by HotTuna
Additions:
~- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
Deletions:
~- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
Edited on 2006-05-26 19:01:49 by ShoeyFighter [Added note about needing Java 1.5]
Additions:
Run the application by typing this at the command line (Note: You must be running java 1.5 or better):
Deletions:
Run the application by typing this at the command line:
Edited on 2006-04-08 12:32:58 by JaQa
Additions:
~- Freenet Fever∞: a guide to inserting a page to Freenet using jSite.
Niky's Home∞ another guide to inserting a page to Freenet using jSite.
Deletions:
~- <a href="http://127.0.0.1:8888/USK@rlpJaSeog8VqJ9GF-qZJ2~xsr3YnQMt8zl0YS8XAgig,v~nOY~IosUP~mnMdXjYYAlCCK9aTZ4TXm4veIgF32Cs,AQABAAE/fever/2/">Freenet∞ Fever</a>: a guide to inserting a page to Freenet using jSite.
<a href="http://127.0.0.1:8888/SSK@rd0SN1AKJoGuNuI9m4~l8wXvbRflzEftZtdwL93UnZE,DWYR7lT4yiJEpjKeUJwyvfo3X2FyM9TZSzXpDEVTotA,AQABAAE/nikyshome/8/">Niky's∞ Home</a> another guide to inserting a page to Freenet using jSite.
Edited on 2006-04-08 12:31:45 by JaQa
Additions:
See also
These are Freenet 0.7 links, so you need Freenet running to use them:
Edited on 2006-04-07 22:06:08 by JaQa
Additions:
~~- The first part is http://localhost:8888/
- Then add the contents of the Request URI field: freenet:SSK@fgh6yZ...BABAA/ (the freenet: is actually optional).
- Then add the contents of the Path field, followed by a dash: mysite-
- Then add the contents of the Edition field, less one. So if it is 2, put 1
- Finally, put a / at the end.
So putting it all together, you should have something like: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/
Deletions:
~~- The first part is http://localhost:8888/∞
- Then add the contents of the Request URI field: freenet:SSK@fgh6yZ...BABAA/ (the freenet: is actually optional).
- Then add the contents of the Path field, followed by a dash: mysite-
- Then add the contents of the Edition field, less one. So if it is 2, put 1
- Finally, put a / at the end.
So putting it all together, you should have something like: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/∞
Edited on 2006-04-07 21:58:48 by JaQa
Additions:
If everything is fine, you should see the Project Insert window.
This has a progress bar as your site is being uploaded to Freenet. It may take several minutes, even for small files, so be patient.
The "Freesite:" line you can see on this window will be part of the address of your new site, but don't worry, you can get this from the main Select a Project windows as well.
When the insert has finished, you will get a message pop up telling you that the project has been inserted successfully. Click OK to this message, and then Next on the Project Insert window.
This will take you back to the first Select a Project window.
- On the left panel, highlight the name of the project you just created, and the fields on the right should get populated with the details you entered earlier.
- To see the site you just added to Freenet, you need to construct the address of the site (the URL) as follows:
- The first part is http://localhost:8888/∞
- Then add the contents of the Request URI field: freenet:SSK@fgh6yZ...BABAA/ (the freenet: is actually optional).
- Then add the contents of the Path field, followed by a dash: mysite-
- Then add the contents of the Edition field, less one. So if it is 2, put 1
- Finally, put a / at the end.
- So putting it all together, you should have something like: http://localhost:8888/freenet:SSK@fgh6yZ...BABAA/mysite-1/∞
Check you can visit your site by putting this address into a web browser.
If it works, congratulations! You've just added your freesite to Freenet.
Deletions:
If everything is fine, you should see the Project Insert window with a progress bar as your site is being uploaded to Freenet. It may take several minutes, even for small files, so be patient.
The "Freesite:" line you can see on this window will be part of the address of your new site, but don't worry, you can get this from the main Select a Project windows as well.
When the insert has finished, you will get a message pop up telling you that the project has been inserted successfully. Click OK to this message, and then Next on the Project Insert window. This will take you back to the first Select a Project window.
Oldest known version of this page was edited on 2006-04-07 21:44:24 by JaQa []
Page view:
jSite
jSite is a graphical application that you can use to create, insert and manage your own Freenet sites. It was written in Java by Bombe. You can download it from here:
http://downloads.freenetproject.org/alpha/jSite/∞.
Download the
jSite.jar∞ file and store it somewhere (in your Freenet installation directory maybe?).
Run the application by typing this at the command line:
java -jar jSite.jar
You should see a window titled
Select a Project.
- Click on the Add Project button.
- Under the Project Information section, enter:
- Name - this is just a name for you to know the project, so anything will do. It can contain spaces.
- Description - again, just a slightly longer description of the project for you own convenience.
- Local Path - This is a directory where you will store all the pages of the freesite you are creating. Put in the full path. You can click the Browse button to select a directory graphically or just type it in.
- Under the Address section, you have:
- Request URI - this is filled in automatically and should be a long string of seemingly random characters starting "freenet:SSK@..."
- Insert URI - this is also filled in automatically and will look similar to the Request URI..
- Path - You need to enter a single word here without spaces. This will appear at the end of the address of your site. You can't leave this blank.
- Edition - this should be automatically set to the next version that is to be inserted.
- Now click the Next button.
The next window is called
Project Files.
- At the moment the area at the top is blank because we haven't created any files to make up our freesite. So, keeping jSite open in the background, create some HTML files using whatever web designing application you prefer, and save them in the Local Path directory you specified earlier.
- Go back to the jSite window and click the Re-scan button. You should now see the files you just added in the top area.
- Highlight one of these files that will be your default page (e.g. index.html might be a good choice) and check the Default file checkbox. It should recognise the MIME type as text/html, so leave everything else as they are and click the Next button.
If everything is fine, you should see the
Project Insert window with a progress bar as your site is being uploaded to Freenet. It may take several minutes, even for small files, so be patient.
The "Freesite:" line you can see on this window will be part of the address of your new site, but don't worry, you can get this from the main
Select a Project windows as well.
When the insert has finished, you will get a message pop up telling you that the project has been inserted successfully. Click
OK to this message, and then
Next on the
Project Insert window. This will take you back to the first
Select a Project window.