UGO | |
ABOUT | |
With ugo you can show a summary of the last "X" files | |
(where X is a number you choose) in a specific directory in | |
your gopher hole, sorted chronologically (the last file | |
created will be the first, and so on). It will show only | |
the fisrt paragraph of your files and will use as title | |
their last modification date.[1] | |
You could find ugo useful if you want to have a gopher | |
log ("glog", "phlog", or whatever). | |
It's possible to find an example of its output here: | |
chr's log | |
Note: All the scripts present here are "beta". That means | |
that they probably won't work as expected. I've been using | |
them and they've been working fine, but things could | |
probably change. | |
Note: The files are compressed with "zip". After you | |
download a file (e.g., "snarf FILE.zip"), you'll have to | |
decompress it (that is, "unzip FILE.zip") and, if the file | |
is "download-ugo.sh" or "ugo.sh", make it user executable | |
(e.g., "chmod u+x FILE.sh"). | |
FOR THE IMPATIENT | |
You can download this script: | |
download-ugo.sh.zip | |
make it executable (chmod u+x download-ugo.sh) and run | |
it. It will download ugo and co., create all the needed | |
stuff and write a first post. Then, you can visit: | |
gopher://sdf.lonestar.org/1/users/YOUR-USER-NAME/log/ | |
and view your log! Otherwise, you can read more info | |
below. | |
INSTALLATION | |
It's a shell script, so you have to download it: | |
ugo.sh.zip | |
make it user executable and run it it wherever you like. | |
You'll need to specify a directory with the variable | |
$LOG_DIRECTORY, relative to your gopher directory,[2] | |
where you'll write your posts (by default it will read | |
.txt file, but you can change the extension). | |
OPTIONS | |
The script uses a configuration file, ".ugorc", that will | |
be placed in $LOG_DIRECTORY (not in your $HOME). All | |
variables that involve files are relative to | |
$LOG_DIRECTORY. | |
If you want a "banner" (header) specify its location in | |
the variable $LOG_BANNER. | |
You can use "comment.cgi" if you want to allow comments to | |
your posts: | |
comments.cgi.zip | |
The option is enabled by default. With it, the script will | |
generate auxiliary files for every file in the frontpage, | |
with extension "go" (can be changed in .ugorc) that will | |
be like gophermaps. That is, you will have your original | |
"mypost.txt" and "mypost.txt.go", but the latter will have | |
a syntax that make it possible to add links. Specifically, | |
that file is needed to put a link that people can use to | |
leave a comment to your post. If you enable a "pheed",[2] | |
specify its location in $PHEED. | |
It's also possible to have an archive page that will have | |
links to older files (grouped by year and month) with | |
their modification time appended. | |
archive.cgi.zip | |
If you want to use "comment.cgi" and/or "archive.cgi", | |
you'll have to download the relative file, put it in your | |
$LOG_DIRECTORY and make it executable by the server | |
(chmod 750). | |
If you *don't* want comments or archive, you can leave the | |
variables $COMM_SCRIPT or $ARCH_SCRIPT (respectively) | |
blank. The same for $PHEED. | |
USAGE | |
ugo.sh [ [FLAG] [FILE.txt] ] | |
If you run it as "ugo.sh", it will update the gophermap in | |
$LOG_DIRECTORY. If you run it as "ugo.sh FILE.txt", it | |
will let you create the file FILE.txt with your $EDITOR | |
(or $VISUAL or vi) and update the gophermap in | |
$LOG_DIRECTORY. Finally, if you run it as "ugo FLAG", it | |
its behaviour will be defined by FLAG. Here's a summary of | |
FLAGs and what ugo will do: | |
+-----------------------------------------------------------------+ | |
| FLAG | FUNCTION | | |
+----------------+------------------------------------------------+ | |
| ls | Show a list of .txt files in $LOG_DIRECTORY | | |
+----------------|------------------------------------------------+ | |
| mod FILE.txt | Modify a file without changing its modif. time | | |
+-----------------------------------------------------------------+ | |
More to come... | |
MISC | |
Ah.. "ugo" stands for Update GOpher. | |
[1] The script is quite SDF specific. | |
[2] For instance, put LOG_DIRECTORY=log if the directory you | |
want to use is located in /ftp/users/$USER/log | |
[3] A "pheed" is like a web feed. New comments will appear | |
there. It's optional, as comments will always appear in | |
the page they refer. The "pheed" idea is not mine. See | |
georg |