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 <solene@perso.pw>	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/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+Xname<TAB>selector<TAB>host<TAB>port	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
.