removing too technical content - gopher-tutorials - The gopher tutorials project.
HTML git clone git://bitreich.org/gopher-tutorials/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/gopher-tutorials/
DIR Log
DIR Files
DIR Refs
DIR Tags
---
DIR commit 2eb761ef9eb86c59f63f78a0504deee794bb4582
DIR parent d690f16558f22431a1aa05e2b25898a9e96b649d
HTML Author: Solene Rapenne <solene@perso.pw>
Date: Tue, 30 Jan 2018 19:54:17 +0100
removing too technical content
Diffstat:
M beginners.txt | 58 ++++++-------------------------
1 file changed, 11 insertions(+), 47 deletions(-)
---
DIR diff --git a/beginners.txt b/beginners.txt
@@ -10,46 +10,34 @@ common service for different people, everyone needing to respect
thoses rules to be able to communicate with each other. Some people
writing code (called Developers) will write "Clients" software for the
end-user and others developers will write "Servers" software which
-will allow to publish content. The Gopher protocol is so simple that
+will allow to publish content. The gopher protocol is so simple that
anyone with basic knowledge of computer science can write its own
-client or server easily. Using Gopher implies to understand the
+client or server easily. Using gopher implies to understand the
protocol itself, but we promise it's really easy.
Gopher is an enjoyable way to browse informations. Every gopherhole
[that is the name given to someone's gopher content] looks like
another one. There is no way to customize a gopherhole display except
-from the text. While this can look a bit harsh, this makes Gopher
+from the text. While this can look a bit harsh, this makes gopher
universal. If you know how to browse one gopherhole, you will know how
to browse all others because the way to do it is consistent.
-So, let's speak about how Gopher works. First, Gopher requires 3
+So, let's speak about how gopher works. First, gopher requires 3
informations if you want to get content. You will need a remote
address to connect to [it's called an hostname, like "floodgap.com"],
the data type and a path to the data. The url looks like this :
gopher://hostname/type/path
-The most important type is the type 1, which is the Gopher menu
-type. A Gopher menu is an index made of differents lines, each line
+The most important type is the type 1, which is the gopher menu
+type. A gopher menu is an index made of differents lines, each line
having a type field to know what kind of data it leads to. It will
allow you to browse from menu to menu or from a menu to a content
(image, text, music, archives...).
-Each line of a menu contains 4 fields separated by a Tabulate
-character. The fields are, in order :
-
-1. text to display (with the first character being the type)
-2. path to the content on the remote server
-3. hostname of the remote server which contains the content
-4. TCP Port[1] of the remote server (default is 70)
-
-The tricky part is that the type of the line is not a separate field,
-it is the first character of the line which is contained inside the first
-field. Gopher clients usually hide it when displaying the text.
-
-Here is the list of the most used data types allowed on Gopher, the
+Here is the list of the most used data types allowed on gopher, the
complete list is defined in a document named RFC 1436 which defines
-the Gopher protocol :
+the gopher protocol :
- type i is a line of text in the menu, it's not a link
- type 0 is a link to a text document
@@ -64,30 +52,6 @@ the Gopher protocol :
Only the types menu and search can lead to another content. Asking
another type will lead to downloading a file.
-When requesting a Gopher menu, the text transferred through the
-network could be read as-this, without a Gopher client. When a server
-responds a menu with a few entries, the raw content transmitted to the
-client looks like this :
-
-iText here, others fields are set with the null value null null null
-1Another gopher menu /help/ floodgap.com 70
-1The menu leading to this help /tutorial/ bitreich.org 70
-IA cut cat picture /cute-cat.jpg floodgap.com 70
-
-The previous menu will display 4 lines, the first will be a text and
-the others last 3 lines will be links to another content, as you may
-have noticed, the server is not necesserarly the same for every
-line. Gopher allows to go to another server from another in a
-transparent manner. A Gopher client could render the previous menu
-like this, allowing to select the lines using arrows on the keyboard :
-
- | Text here, others fields are set with the null value
-MENU | Another gopher menu
-MENU | The menu leading to this help
-IMAGE | A cut cat picture
-
-
-[1] : a TCP Port could be explained as a door on a server where a
- network service waits behind. You need to knock to the right
- door when you reach the server. Gopher waits by default
- behind the port 70.
+Now that you are ready to browse the gopher space, we recommend you to
+read the others tutorials about the gopher client software you would
+like to use.