iMerge branch 'master' of ssh://bitreich.org///scm/gopher-tutorials - gopher-tutorials - The gopher tutorials project. Err bitreich.org 70 hgit clone git://bitreich.org/gopher-tutorials/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/gopher-tutorials/ URL:git://bitreich.org/gopher-tutorials/ git://enlrupgkhuxnvlhsf6lc3fziv5h2hhfrinws65d7roiv6bfj7d652fid.onion/gopher-tutorials/ bitreich.org 70 1Log /scm/gopher-tutorials/log.gph bitreich.org 70 1Files /scm/gopher-tutorials/files.gph bitreich.org 70 1Refs /scm/gopher-tutorials/refs.gph bitreich.org 70 1Tags /scm/gopher-tutorials/tag bitreich.org 70 i--- Err bitreich.org 70 1commit a7b2ac2ae2a804295e0a0789c76e2549ca0d2d1f /scm/gopher-tutorials/commit/a7b2ac2ae2a804295e0a0789c76e2549ca0d2d1f.gph bitreich.org 70 1parent 33d1b266be78013782311961b15777ee2cd75c4e /scm/gopher-tutorials/commit/33d1b266be78013782311961b15777ee2cd75c4e.gph bitreich.org 70 hAuthor: Solene Rapenne URL:mailto:solene@perso.pw bitreich.org 70 iDate: Tue, 5 Jun 2018 15:00:14 +0200 Err bitreich.org 70 i Err bitreich.org 70 iMerge branch 'master' of ssh://bitreich.org///scm/gopher-tutorials Err bitreich.org 70 i Err bitreich.org 70 iDiffstat: Err bitreich.org 70 i M clients.txt | 18 ++++++++++++++++++ Err bitreich.org 70 i M index.gph | 20 ++++++++++---------- Err bitreich.org 70 i A publish-gophernicus.txt | 54 +++++++++++++++++++++++++++++++ Err bitreich.org 70 i A publishing-guideline.txt | 69 ++++++++++++++++++++++++++++++ Err bitreich.org 70 i Err bitreich.org 70 i4 files changed, 151 insertions(+), 10 deletions(-) Err bitreich.org 70 i--- Err bitreich.org 70 1diff --git a/clients.txt b/clients.txt /scm/gopher-tutorials/file/clients.txt.gph bitreich.org 70 i@@ -60,3 +60,21 @@ RuGopher is an open-source graphical gopher client written in Ruby. Err bitreich.org 70 i You can fetch the sources at the following GIT repository : Err bitreich.org 70 i Err bitreich.org 70 i https://github.com/Val6789/RuGopher.git Err bitreich.org 70 i+ Err bitreich.org 70 i+VF-1 Err bitreich.org 70 i+==== Err bitreich.org 70 i+ Err bitreich.org 70 i+VF-1 is an open source text-based gopher client written in Python 3, Err bitreich.org 70 i+which uses external programs to handle different item types. It also Err bitreich.org 70 i+sports some advanced navigation features, such as link extraction from Err bitreich.org 70 i+type 0 items, jumping to next/previous item in a menu without Err bitreich.org 70 i+returning to the menu, marking items with a single character (cf vim Err bitreich.org 70 i+marks) and queuing up items to visit in a FIFO list called a "tour". Err bitreich.org 70 i+ Err bitreich.org 70 i+Souce is at: Err bitreich.org 70 i+ Err bitreich.org 70 i+ https://github.com/solderpunk/VF-1 Err bitreich.org 70 i+ Err bitreich.org 70 i+VF-1 is also on PyPi so it can be installed with: Err bitreich.org 70 i+ Err bitreich.org 70 i+ pip3 install VF-1 Err bitreich.org 70 1diff --git a/index.gph b/index.gph /scm/gopher-tutorials/file/index.gph.gph bitreich.org 70 i@@ -9,24 +9,24 @@ ttechnical skill levels. Err bitreich.org 70 i Err bitreich.org 70 i ___________________________U_S_I_N_G__G_O_P_H_E_R________________________ Err bitreich.org 70 i Err bitreich.org 70 i-[0|Tutorial for absolute beginners.|/tutorial/beginners.txt|server|port] Err bitreich.org 70 i+[0|Tutorial for absolute beginners.|/tutorials/beginners.txt|server|port] Err bitreich.org 70 i Err bitreich.org 70 i Clients: Err bitreich.org 70 i-[0|Using your web browser to explore Gopherspace. (floodgap.com)|/gopher/wbgopher|floodgap.com|70] Err bitreich.org 70 i-[0|The Overbite Project – gopher for firefox|/overbite|floodgap.com|70] Err bitreich.org 70 i-[0|Legacy clients (floodgap.com)|/gopher/clients|floodgap.com|70] Err bitreich.org 70 i-[0|How to use sacc.|/tutorial/sacc.txt|server|port] Err bitreich.org 70 i-[0|How to use a gopherproxy.|/tutorial/proxy.txt|server|port] Err bitreich.org 70 i-[0|How to use gopher in firefox or chromium.|/tutorial/overbite.txt|server|port] Err bitreich.org 70 i+[1|Using your web browser to explore Gopherspace. (floodgap.com)|/gopher/wbgopher|floodgap.com|70] Err bitreich.org 70 i+[1|The Overbite Project – gopher for firefox|/overbite|floodgap.com|70] Err bitreich.org 70 i+[1|Legacy clients (floodgap.com)|/gopher/clients|floodgap.com|70] Err bitreich.org 70 i+[0|How to use sacc.|/tutorials/sacc.txt|server|port] Err bitreich.org 70 i+[0|How to use a gopherproxy.|/tutorials/proxy.txt|server|port] Err bitreich.org 70 i+[0|How to use gopher in firefox or chromium.|/tutorials/overbite.txt|server|port] Err bitreich.org 70 i [0|How to use lynx or w3m for gopher.|/tutorials/lynx-w3m.txt|server|port] Err bitreich.org 70 i [0|Commandline clients for gopher (curl, snarf ...)|/tutorials/cmdline.txt|server|port] Err bitreich.org 70 i Err bitreich.org 70 i-[0|Other clients available.|/tutorial/clients.txt|server|port] Err bitreich.org 70 i+[0|Other clients available.|/tutorials/clients.txt|server|port] Err bitreich.org 70 i Err bitreich.org 70 i ____________________J_O_I_N_I_N_G__T_H_E__C_O_M_M_U_N_I_T_Y______________ Err bitreich.org 70 i Err bitreich.org 70 i-[0|Join the community on IRC.|/tutorial/irc.txt|server|port] Err bitreich.org 70 i-[0|Join the mailinglist.|/tutorial/gopher-ml.txt|server|port] Err bitreich.org 70 i+[0|Join the community on IRC.|/tutorials/irc.txt|server|port] Err bitreich.org 70 i+[0|Join the mailinglist.|/tutorials/gopher-ml.txt|server|port] Err bitreich.org 70 i Err bitreich.org 70 i ________________________________H_I_S_T_O_R_Y____________________________ Err bitreich.org 70 i Err bitreich.org 70 1diff --git a/publish-gophernicus.txt b/publish-gophernicus.txt /scm/gopher-tutorials/file/publish-gophernicus.txt.gph bitreich.org 70 i@@ -0,0 +1,54 @@ Err bitreich.org 70 i+Gophernicus is quite fussy about permissions, to minimise the risk of Err bitreich.org 70 i+accidentally serving files not intended for public consumptions. Only Err bitreich.org 70 i+world accessible content will be served, so chmod files o+r and Err bitreich.org 70 i+directories o+rw. This is a common cause of confusion and frustration Err bitreich.org 70 i+for beginners. Err bitreich.org 70 i+ Err bitreich.org 70 i+Gophernicus supports so-called "personal gopherspaces". If a user Err bitreich.org 70 i+"bob" has a directory named "public_gopher" in their home directory, Err bitreich.org 70 i+then the file /home/bob/public_gopher/foo/bar/baz.ext will be Err bitreich.org 70 i+accessible via the selector ~bob/foo/bar/baz.ext (if permissions Err bitreich.org 70 i+allow). The name of the "public_gopher" directory can be changed via Err bitreich.org 70 i+the -u option. This is a convenient feature for those who want to Err bitreich.org 70 i+host multiple users, although it can of course be emulated with Err bitreich.org 70 i+symlinks for other server software. Err bitreich.org 70 i+ Err bitreich.org 70 i+Automatically generated directory listings list files in alphabetical Err bitreich.org 70 i+order. This is less than ideal for phloggers who usually want the Err bitreich.org 70 i+most recent entry to appear at the top. The conventional workaround Err bitreich.org 70 i+for this seems to be to prefix filenames with some kind of timestamp Err bitreich.org 70 i+that sorts nicely alphabetically. YYYYMMDD timestamps obviously work Err bitreich.org 70 i+nicely, but a three-character alphanumeric code also sees some use, Err bitreich.org 70 i+see e.g. gopher://grex.org:70/0/~tfurrows/phlog_filename.txt. Err bitreich.org 70 i+ Err bitreich.org 70 i+Automatically generated menus can be overridden by creating a file Err bitreich.org 70 i+named "gophermap" in any directory. Menu items are specified with Err bitreich.org 70 i+lines of the type: Err bitreich.org 70 i+ Err bitreich.org 70 i+Xnameselectorhostport Err bitreich.org 70 i+ Err bitreich.org 70 i+where X is the gopher item type. The host and port may be omitted, Err bitreich.org 70 i+in which case they will be set to the same host and port that the Err bitreich.org 70 i+server is running on (the server's idea of its own hostname can be Err bitreich.org 70 i+forced with the -h option). The selector may also be omitted, in Err bitreich.org 70 i+which case it will be set equal to the name. Lines not beginning Err bitreich.org 70 i+with a valid item type or with one of Gophernicus' own non-standard Err bitreich.org 70 i+control characters are treated as information lines (type i). Err bitreich.org 70 i+ Err bitreich.org 70 i+It is important to note that selectors which do not begin with a / Err bitreich.org 70 i+will be interpreted as *relative* links, e.g. a selector of "bar" Err bitreich.org 70 i+specified in "foo/gophermap" will point to "foo/bar". Selectors Err bitreich.org 70 i+beginning with / are treated as absolute links. Some other gopher Err bitreich.org 70 i+servers with seemingly compatible gophermap syntax (e.g. PyGopherd) Err bitreich.org 70 i+treat all selectors as absolute and this can cause headaches when Err bitreich.org 70 i+attempting to port gophermaps from one server to another. Err bitreich.org 70 i+ Err bitreich.org 70 i+Dynamically generated menus are possible by making the "gophermap" Err bitreich.org 70 i+file a world-executable script which produces output on stdout of Err bitreich.org 70 i+exactly the same format as a static gophermap. Err bitreich.org 70 i+ Err bitreich.org 70 i+As a lightweight alternative to gophermaps, a file named "gophertag" Err bitreich.org 70 i+may be placed in any directory containing a "user friendly" name for Err bitreich.org 70 i+that directory to be used in automatically generated listings (e.g. Err bitreich.org 70 i+you could placed a gophertag file containing the text Err bitreich.org 70 i+"Miscellaneous photographs" in the directory "misc_photos"). Err bitreich.org 70 1diff --git a/publishing-guideline.txt b/publishing-guideline.txt /scm/gopher-tutorials/file/publishing-guideline.txt.gph bitreich.org 70 i@@ -0,0 +1,69 @@ Err bitreich.org 70 i+This document will give you a few hints about publishing through Err bitreich.org 70 i+gopher. Err bitreich.org 70 i+ Err bitreich.org 70 i+Line length Err bitreich.org 70 i+=========== Err bitreich.org 70 i+ Err bitreich.org 70 i+The rendering of content is client specific. However most clients Err bitreich.org 70 i+will present the user with a text based interface, so you should be Err bitreich.org 70 i+conservative on the maximum line length in your menus. As clients Err bitreich.org 70 i+will add a couple of characters to mark item types, a line width of Err bitreich.org 70 i+69 characters is recommended. Err bitreich.org 70 i+ Err bitreich.org 70 i+The menu Err bitreich.org 70 i+======== Err bitreich.org 70 i+ Err bitreich.org 70 i+The main entry point and user interface between your readers and your Err bitreich.org 70 i+content is the gopher menu item (item '1' as you may recall). The Err bitreich.org 70 i+selectors in a menu will define the information hierarchy. Choose a Err bitreich.org 70 i+flat hierarchy if you can so readers will get to the content easily Err bitreich.org 70 i+and without traversing too many menus. Err bitreich.org 70 i+ Err bitreich.org 70 i+Use helpful item descriptions for your selectors, this will aid both Err bitreich.org 70 i+human and nonhuman readers: indexers will most likely index menu Err bitreich.org 70 i+items only. Be as specific as possible. If it is a binary item type Err bitreich.org 70 i+hint at its intended format, so your readers will know what to Err bitreich.org 70 i+expect. Using a useful filename scheme for selectors is also helpful. Err bitreich.org 70 i+ Err bitreich.org 70 i+You may decorate your menus with informational items (item 'i'). Err bitreich.org 70 i+Clients will display them as is without additional tags. Around the Err bitreich.org 70 i+gopherspace a lot of ASCII art is used to create a pleasant Err bitreich.org 70 i+appearance of a gopher site. Some services also include explanations Err bitreich.org 70 i+for the specific menu, and use 'i' items for grouping selectors. Err bitreich.org 70 i+ Err bitreich.org 70 i+There are clients that do not offer a 'back' button. Be kind to those Err bitreich.org 70 i+users and provide navigational selectors in your menus. Make the Err bitreich.org 70 i+journey through your gopher space easy! Err bitreich.org 70 i+ Err bitreich.org 70 i+On your travels through gopher sites, you will encounter gopher sites Err bitreich.org 70 i+that use menu and informational items to mimick a page with embedded Err bitreich.org 70 i+links. There is an ongoing dispute whether this is good style. We do Err bitreich.org 70 i+not recommend this style as it delutes the meaning of the menu item. Err bitreich.org 70 i+For starters you should stick to single file items to store your Err bitreich.org 70 i+content. Once you gain more experience with publishing content in Err bitreich.org 70 i+gopher you can always change your mind later! Err bitreich.org 70 i+ Err bitreich.org 70 i+Selector hierarchy Err bitreich.org 70 i+================== Err bitreich.org 70 i+ Err bitreich.org 70 i+By design a gopher site should present a hierarchy of content Err bitreich.org 70 i+selectors to the user. These mimick a file system by intention. Err bitreich.org 70 i+However this does not need to mtch the real hierarchy of your storage Err bitreich.org 70 i+filesystem. An example: Err bitreich.org 70 i+ Err bitreich.org 70 i+Alicia has a gopher blog (aka 'phlog'). She writes daily posts. To Err bitreich.org 70 i+make it easy on her users she has a menu item on the phlog/ selector Err bitreich.org 70 i+that presents the latest 5 posts and a selector to an archive menu Err bitreich.org 70 i+linking to all her posts. On disk however both the menus and the Err bitreich.org 70 i+articles reside in the same directory. A script creates the Err bitreich.org 70 i+selectors in the menu files and rotates them. The post files however Err bitreich.org 70 i+remain untouched and their selectors will not change over time. This Err bitreich.org 70 i+means that external links to her post will still be valid later. Err bitreich.org 70 i+ Err bitreich.org 70 i+Site generators Err bitreich.org 70 i+=============== Err bitreich.org 70 i+ Err bitreich.org 70 i+The easiest creation of content is done manually. If you would like Err bitreich.org 70 i+to automate some task then there are site generators. Most of these Err bitreich.org 70 i+consists of a collection of shell scripts you can adapt to your Err bitreich.org 70 i+needs. Search veronica for cl-yag or burrow for starters. Err bitreich.org 70 .