stagit-gopher - www.codemadness.org - www.codemadness.org saait content files
HTML git clone git://git.codemadness.org/www.codemadness.org
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
stagit-gopher (4927B)
---
1 1<- Back / codemadness.org 70
2 i codemadness.org 70
3 i codemadness.org 70
4 i# Stagit-gopher: a static git page generator for gopher codemadness.org 70
5 i codemadness.org 70
6 iLast modification on 2021-04-11 codemadness.org 70
7 i codemadness.org 70
8 istagit-gopher is a static page generator for Gopher. It creates the pages as codemadness.org 70
9 hstatic »geomyidae« .gph files. stagit-gopher is a modified version from the URL:http://git.r-36.net/geomyidae/ codemadness.org 70
10 iHTML version of stagit. codemadness.org 70
11 i codemadness.org 70
12 1Read the README for more information about it. /git/stagit-gopher/file/README.gph codemadness.org 70
13 i codemadness.org 70
14 iI also run a gopherhole and stagit-gopher, you can see how it looks here: codemadness.org 70
15 1gopher://codemadness.org/1/git/ /git/ codemadness.org 70
16 i codemadness.org 70
17 h»sacc« is a good Gopher client to view it. URL:https://git.fifth.space/sacc/log.html codemadness.org 70
18 i codemadness.org 70
19 i codemadness.org 70
20 i## Features codemadness.org 70
21 i codemadness.org 70
22 i* Log of all commits from HEAD. codemadness.org 70
23 i* Log and diffstat per commit. codemadness.org 70
24 i* Show file tree with line numbers. codemadness.org 70
25 i* Show references: local branches and tags. codemadness.org 70
26 i* Detect README and LICENSE file from HEAD and link it as a webpage. codemadness.org 70
27 i* Detect submodules (.gitmodules file) from HEAD and link it as a webpage. codemadness.org 70
28 i* Atom feed of the commit log (atom.xml). codemadness.org 70
29 i* Atom feed of the tags/refs (tags.xml). codemadness.org 70
30 i* Make index page for multiple repositories with stagit-gopher-index. codemadness.org 70
31 i* After generating the pages (relatively slow) serving the files is very fast, codemadness.org 70
32 i simple and requires little resources (because the content is static), a codemadness.org 70
33 i geomyidae Gopher server is required. codemadness.org 70
34 i* Security: all pages are static. No CGI or dynamic code is run for the codemadness.org 70
35 i interface. Using it with a secure Gopher server such as geomyidae it is codemadness.org 70
36 i privilege-dropped and chroot(2)'d. codemadness.org 70
37 i* Simple to setup: the content generation is clearly separated from serving it. codemadness.org 70
38 i This makes configuration as simple as copying a few directories and scripts. codemadness.org 70
39 h* Usable with Gopher clients such as lynx and »sacc«. URL:https://git.fifth.space/sacc/log.html codemadness.org 70
40 i codemadness.org 70
41 i codemadness.org 70
42 i## Cons codemadness.org 70
43 i codemadness.org 70
44 i* Not suitable for large repositories (2000+ commits), because diffstats are codemadness.org 70
45 i an expensive operation, the cache (-c flag) is a workaround for this in codemadness.org 70
46 i some cases. codemadness.org 70
47 i* Not suitable for large repositories with many files, because all files are codemadness.org 70
48 i written for each execution of stagit. This is because stagit shows the lines codemadness.org 70
49 i of textfiles and there is no "cache" for file metadata (this would add more codemadness.org 70
50 i complexity to the code). codemadness.org 70
51 i* Not suitable for repositories with many branches, a quite linear history is codemadness.org 70
52 i assumed (from HEAD). codemadness.org 70
53 i* Relatively slow to run the first time (about 3 seconds for sbase, codemadness.org 70
54 i 1500+ commits), incremental updates are faster. codemadness.org 70
55 i* Does not support some of the dynamic features cgit has (for HTTP), like: codemadness.org 70
56 i * Snapshot tarballs per commit. codemadness.org 70
57 i * File tree per commit. codemadness.org 70
58 i * History log of branches diverged from HEAD. codemadness.org 70
59 i * Stats (git shortlog -s). codemadness.org 70
60 i codemadness.org 70
61 i codemadness.org 70
62 iThis is by design, just use git locally. codemadness.org 70
63 i codemadness.org 70
64 i codemadness.org 70
65 i## Clone codemadness.org 70
66 i codemadness.org 70
67 i git clone git://git.codemadness.org/stagit-gopher codemadness.org 70
68 i codemadness.org 70
69 i codemadness.org 70
70 i## Browse codemadness.org 70
71 i codemadness.org 70
72 iYou can browse the source-code at: codemadness.org 70
73 i codemadness.org 70
74 h* https://git.codemadness.org/stagit-gopher/ URL:https://git.codemadness.org/stagit-gopher/ codemadness.org 70
75 1* gopher://codemadness.org/1/git/stagit-gopher /git/stagit-gopher codemadness.org 70
76 i codemadness.org 70
77 i codemadness.org 70
78 i## Download releases codemadness.org 70
79 i codemadness.org 70
80 iReleases are available at: codemadness.org 70
81 i codemadness.org 70
82 h* https://codemadness.org/releases/stagit-gopher/ URL:https://codemadness.org/releases/stagit-gopher/ codemadness.org 70
83 1* gopher://codemadness.org/1/releases/stagit-gopher /releases/stagit-gopher codemadness.org 70
84 .