removing too technical content - gopher-tutorials - The gopher tutorials projec… | |
git clone git://bitreich.org/gopher-tutorials/ git://enlrupgkhuxnvlhsf6lc3fziv5… | |
Log | |
Files | |
Refs | |
Tags | |
--- | |
commit 2eb761ef9eb86c59f63f78a0504deee794bb4582 | |
parent d690f16558f22431a1aa05e2b25898a9e96b649d | |
Author: Solene Rapenne <[email protected]> | |
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(-) | |
--- | |
diff --git a/beginners.txt b/beginners.txt | |
@@ -10,46 +10,34 @@ common service for different people, everyone needing to re… | |
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 … | |
-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. |