1 85466e34 2023-02-28 jrmu version=pmwiki-2.2.130 ordered=1 urlencoded=1
2 85466e34 2023-02-28 jrmu agent=Mozilla/5.0 (Windows NT 10.0; rv:106.0) Gecko/20100101 Firefox/106.0
3 85466e34 2023-02-28 jrmu author=fossdev
4 85466e34 2023-02-28 jrmu charset=UTF-8
6 85466e34 2023-02-28 jrmu ctime=1677413778
7 85466e34 2023-02-28 jrmu host=223.177.87.51
8 85466e34 2023-02-28 jrmu name=Stagit.Install
11 85466e34 2023-02-28 jrmu text=This guide assumes that you are familiar with%0a[[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and%0a[[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repos]]%0awhich are located at @@/var/www/got/public/@@.%0a%0aThis guide also assumes that you have properly configured%0a[[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] with @@git@@ as a%0a[[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|subdomain]].%0a%0a'''NOTE''': Replace all the instances of example.com with your domain.%0a%0a%0a!!Overview%0a%0a[[https://codemadness.org/stagit.html|stagit]]%0ais a simple static page generator for git.%0aIt generates static HTML pages for a git repository.%0a%0a!!!Advantages%0a%0a# It is written in C (with support for pledge and unveil).%0a# The code base is very simple and is about 1.5K LOC.%0a# Work very well with text-based browsers such as lynx and w3m.%0a# No CGI or dynamic code is required.%0a# No configuration required.%0a# Atom feed of the commit and tags/refs.%0a%0a!!!Disadvantages%0a%0a# Depends on libgit2.%0a# Not suitable for large repo with many files, commits(2000+), or branches.%0a# Does not support features like:%0a## Snapshot tarballs per commit.%0a## File tree per commit.%0a## History log of branches diverged from HEAD.%0a## Stats (git shortlog -s).%0a# This is by design, just use git locally.%0a%0a%0a!!Installation%0a%0aInstall the dependency:%0a%0a[@%0a$ doas pkg_add libgit2%0a@]%0a%0aGet the latest release of stagit from%0a[[https://codemadness.org/releases/stagit/|here]].%0aAt the time of writing, it was 1.2. %0a%0a[@%0a$ ftp https://codemadness.org/releases/stagit/stagit-1.2.tar.gz%0a$ ftp https://codemadness.org/releases/stagit/stagit-1.2.tar.gz.sha256%0a$ sha256 -C stagit-1.2.tar.gz.sha256 stagit-1.2.tar.gz%0a(SHA256) stagit-1.2.tar.gz: OK%0a@]%0a%0aExtract, compile and install:%0a%0a[@%0a$ tar xvzf stagit-1.2.tar.gz%0a$ cd stagit-1.2%0a$ make%0a$ doas make install%0a@]%0a%0aIf you get any error like this:%0a%0a[@%0astagit.c:1239:19: error: use of undeclared identifier 'GIT_OPT_SET_OWNER_VALIDATION'%0a git_libgit2_opts(GIT_OPT_SET_OWNER_VALIDATION, 0);%0a ^%0a@]%0a%0aEdit @@Makefile@@ and uncomment this line:%0a%0a[@%0aSTAGIT_CFLAGS += -DGIT_OPT_SET_OWNER_VALIDATION=-1%0a@]%0a%0aNow you should be able make and install without any error.%0a%0a[@%0a$ make%0a$ doas make install%0a@]%0a%0a%0a!!Configuration%0a%0aEdit @@/etc/httpd.conf@@ and add this section.%0a%0a[@%0aserver "git.example.com" {%0a listen on * port 80%0a root "/htdocs/git.example.com"%0a location "/.well-known/acme-challenge/*" {%0a root "/acme"%0a request strip 2%0a }%0a}%0a@]%0a%0aRestart @@httpd@@:%0a%0a[@%0a$ doas rcctl restart httpd%0a@]%0a%0aFor ssl/tls upport, configure acme-client and relayd.%0a%0a%0a!!Generate static site%0a%0a[@%0a$ doas mkdir -p /var/www/htdocs/git.example.com%0a$ doas cp favicon.png logo.png style.css /var/www/htdocs/git.example.com/%0a$ cd /var/www/htdocs/git.example.com%0a$ doas touch create.sh%0a$ doas chmod +x create.sh%0a@]%0a%0aEdit create.sh and copy-paste the code below:%0a%0a[@%0a#!/bin/sh%0a%0areposdir="/var/www/got/public"%0acurdir="/var/www/htdocs/git.example.com"%0a%0astagit-index "${reposdir}/"*/ > "${curdir}/index.html"%0a%0afor dir in "${reposdir}/"*/; do%0a r=$(basename "${dir}")%0a d=$(basename "${dir}" ".git")%0a printf "%25s... " "${d}"%0a%0a mkdir -p "${curdir}/${d}"%0a cd "${curdir}/${d}" || continue%0a stagit -c ".cache" -u "https://git.example.com/$d/" "${reposdir}/${r}"%0a%0a ln -sf log.html index.html%0a ln -sf ../style.css style.css%0a ln -sf ../logo.png logo.png%0a ln -sf ../favicon.png favicon.png%0a%0a echo "done"%0adone%0a@]%0a%0aRun @@create.sh@@ to generate the html pages for all the repos:%0a%0a[@%0a$ doas ./create.sh%0a@]%0a%0aNow you can visit @@http://git.example.com@@.%0a%0a'''NOTE''': You have to run @@create.sh@@ every time you make changes to the repos.%0a%0aTo change the logo, replace the default @@favicon.png@@ and @@logo.png@@ with%0ayour 32x32 logo and regenerate the html files.%0a%0a%0a!!Add Metadata%0a%0aAdd @@description@@, @@owner@@ and @@url@@ files to all the repos.%0a%0a* description - description of the repo.%0a* owner - owner name of the repo.%0a* url - clone URL of the repo, for example: git://git.example.com/project%0a%0a%0aSee Also: %0a%0a[[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Regenerate on git push or got send]]
12 85466e34 2023-02-28 jrmu time=1677432253
13 85466e34 2023-02-28 jrmu author:1677432253=fossdev
14 85466e34 2023-02-28 jrmu diff:1677432253:1677427569:=155c155%0a%3c $ doas ./create.sh%0a---%0a> # ./create.sh%0a164,172d163%0a%3c %0a%3c %0a%3c !!Add Metadata%0a%3c %0a%3c Add @@description@@, @@owner@@ and @@url@@ files to all the repos.%0a%3c %0a%3c * description - description of the repo.%0a%3c * owner - owner name of the repo.%0a%3c * url - clone URL of the repo, for example: git://git.example.com/project%0a
15 85466e34 2023-02-28 jrmu host:1677432253=223.177.87.51
16 85466e34 2023-02-28 jrmu author:1677427569=fossdev
17 85466e34 2023-02-28 jrmu diff:1677427569:1677415257:=1,9c1,2%0a%3c This guide assumes that you are familiar with%0a%3c [[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and%0a%3c [[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repos]]%0a%3c which are located at @@/var/www/got/public/@@.%0a%3c %0a%3c This guide also assumes that you have properly configured%0a%3c [[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] with @@git@@ as a%0a%3c [[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|subdomain]].%0a%3c %0a---%0a> This guide assumes you are familiar with git/[[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and the [[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repositories]] are located at @@/var/www/got/public/@@.%0a> %0a12d4%0a%3c %0a15,16c7%0a%3c [[https://codemadness.org/stagit.html|stagit]]%0a%3c is a simple static page generator for git.%0a---%0a> [[https://codemadness.org/stagit.html|stagit]] is a simple static page generator for git.%0a31c22%0a%3c # Not suitable for large repo with many files, commits(2000+), or branches.%0a---%0a> # Not suitable for large repositories with many files, commits(2000+), or branches.%0a39d29%0a%3c %0a48,49c38%0a%3c Get the latest release of stagit from%0a%3c [[https://codemadness.org/releases/stagit/|here]].%0a---%0a> Get the latest release of stagit from [[https://codemadness.org/releases/stagit/|here]].%0a72,73c61,62%0a%3c git_libgit2_opts(GIT_OPT_SET_OWNER_VALIDATION, 0);%0a%3c ^%0a---%0a> git_libgit2_opts(GIT_OPT_SET_OWNER_VALIDATION, 0);%0a> ^%0a89d77%0a%3c %0a91a80,81%0a> '''NOTE''': Make sure you have properly configured the [[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] and with a [[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|entry]] for @@git@@ subdomain.%0a> %0a96,101c86,91%0a%3c listen on * port 80%0a%3c root "/htdocs/git.example.com"%0a%3c location "/.well-known/acme-challenge/*" {%0a%3c root "/acme"%0a%3c request strip 2%0a%3c }%0a---%0a> listen on * port 80%0a> root "/htdocs/git.example.com"%0a> location "/.well-known/acme-challenge/*" {%0a> root "/acme"%0a> request strip 2%0a> }%0a105,106c95,98%0a%3c Restart @@httpd@@:%0a%3c %0a---%0a> If you want ssl/tls upport, you have to configure the acme-client and the relayd.%0a> %0a> !!Generate static site%0a> %0a108c100,101%0a%3c $ doas rcctl restart httpd%0a---%0a> # mkdir -p /var/www/htdocs/git.example.com%0a> # cd /var/www/htdocs/git.example.com%0a111,115c104,105%0a%3c For ssl/tls upport, configure acme-client and relayd.%0a%3c %0a%3c %0a%3c !!Generate static site%0a%3c %0a---%0a> Copy @@favicon.png@@, @@logo.png@@ and @@style.css@@ from stagit directory to @@/var/www/htdocs/git.example.com@@.%0a> %0a117,121c107,108%0a%3c $ doas mkdir -p /var/www/htdocs/git.example.com%0a%3c $ doas cp favicon.png logo.png style.css /var/www/htdocs/git.example.com/%0a%3c $ cd /var/www/htdocs/git.example.com%0a%3c $ doas touch create.sh%0a%3c $ doas chmod +x create.sh%0a---%0a> # touch create.sh%0a> # chmod +x create.sh%0a124,125c111,112%0a%3c Edit create.sh and copy-paste the code below:%0a%3c %0a---%0a> Edit create.sh and paste the code below:%0a> %0a135,148c122,135%0a%3c r=$(basename "${dir}")%0a%3c d=$(basename "${dir}" ".git")%0a%3c printf "%25s... " "${d}"%0a%3c %0a%3c mkdir -p "${curdir}/${d}"%0a%3c cd "${curdir}/${d}" || continue%0a%3c stagit -c ".cache" -u "https://git.example.com/$d/" "${reposdir}/${r}"%0a%3c %0a%3c ln -sf log.html index.html%0a%3c ln -sf ../style.css style.css%0a%3c ln -sf ../logo.png logo.png%0a%3c ln -sf ../favicon.png favicon.png%0a%3c %0a%3c echo "done"%0a---%0a> r=$(basename "${dir}")%0a> d=$(basename "${dir}" ".git")%0a> printf "%25s... " "${d}"%0a> %0a> mkdir -p "${curdir}/${d}"%0a> cd "${curdir}/${d}" || continue%0a> stagit -c ".cache" -u "https://git.example.com/$d/" "${reposdir}/${r}"%0a> %0a> ln -sf log.html index.html%0a> ln -sf ../style.css style.css%0a> ln -sf ../logo.png logo.png%0a> ln -sf ../favicon.png favicon.png%0a> %0a> echo "done"%0a152,153c139,140%0a%3c Run @@create.sh@@ to generate the html pages for all the repos:%0a%3c %0a---%0a> Run @@create.sh@@ to generate the html pages for all the repositories located at @@/var/www/got/public@@.%0a> %0a160,168c147,153%0a%3c '''NOTE''': You have to run @@create.sh@@ every time you make changes to the repos.%0a%3c %0a%3c To change the logo, replace the default @@favicon.png@@ and @@logo.png@@ with%0a%3c your 32x32 logo and regenerate the html files.%0a%3c %0a%3c %0a%3c See Also: %0a%3c %0a%3c [[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Regenerate on git push or got send]]%0a\ No newline at end of file%0a---%0a> '''NOTE''': You have to run @@create.sh@@ every time you make changes to the repositories.%0a> %0a> You can replace the default @@favicon.png@@ and @@logo.png@@ with your 32x32 logo.%0a> %0a> !!Next%0a> %0a> [[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Auto generate on git push or got send]]%0a\ No newline at end of file%0a
18 85466e34 2023-02-28 jrmu host:1677427569=223.177.87.51
19 85466e34 2023-02-28 jrmu author:1677415257=fossdev
20 85466e34 2023-02-28 jrmu diff:1677415257:1677415073:=1,4c1,2%0a%3c This guide assumes you are familiar with git/[[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and the [[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repositories]] are located at @@/var/www/got/public/@@.%0a%3c %0a%3c '''NOTE''': Replace all the instances of example.com with your domain.%0a%3c %0a---%0a> This guide assumes you are familiar with git/[[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and the [[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repositories]] are located at @@/var/www/got/public/@@. %0a> %0a81a80,81%0a> '''NOTE''': Replace example.com with your domain.%0a> %0a98a99,100%0a> '''NOTE''': Replace example.com with your domain.%0a> %0a104,105c106,107%0a%3c Copy @@favicon.png@@, @@logo.png@@ and @@style.css@@ from stagit directory to @@/var/www/htdocs/git.example.com@@.%0a%3c %0a---%0a> '''NOTE''': Copy @@favicon.png@@, @@logo.png@@ and @@style.css@@ from stagit directory to @@/var/www/htdocs/git.example.com@@.%0a> %0a149c151%0a%3c You can replace the default @@favicon.png@@ and @@logo.png@@ with your 32x32 logo.%0a---%0a> '''NOTE''': You can replace the default @@favicon.png@@ and @@logo.png@@ with your 32x32 logo.%0a
21 85466e34 2023-02-28 jrmu host:1677415257=223.177.87.51
22 85466e34 2023-02-28 jrmu author:1677415073=fossdev
23 85466e34 2023-02-28 jrmu diff:1677415073:1677414392:=141,146d140%0a%3c Run @@create.sh@@ to generate the html pages for all the repositories located at @@/var/www/got/public@@.%0a%3c %0a%3c [@%0a%3c # ./create.sh%0a%3c @]%0a%3c %0a148,149d141%0a%3c %0a%3c '''NOTE''': You have to run @@create.sh@@ every time you make changes to the repositories.%0a
24 85466e34 2023-02-28 jrmu host:1677415073=223.177.87.51
25 85466e34 2023-02-28 jrmu author:1677414392=fossdev
26 85466e34 2023-02-28 jrmu diff:1677414392:1677414252:=55,56c55,58%0a%3c If you get any error like this:%0a%3c %0a---%0a> !!!Error on older libgit2%0a> %0a> If you get any error something like:%0a> %0a57a60%0a> cc -o stagit.o -c stagit.c -I/usr/local/include -O2 -pipe -D_XOPEN_SOURCE=700 -D_DEFAULT_SOURCE -D_BSD_SOURCE%0a60a64,65%0a> 1 error generated.%0a> *** Error 1 in /home/fossdev/stagit-1.2 (Makefile:54 'stagit.o')%0a
27 85466e34 2023-02-28 jrmu host:1677414392=223.177.87.51
28 85466e34 2023-02-28 jrmu author:1677414252=fossdev
29 85466e34 2023-02-28 jrmu diff:1677414252:1677413951:=150,152c150%0a%3c !!Next%0a%3c %0a%3c [[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Auto generate on git push or got send]]%0a\ No newline at end of file%0a---%0a> Next: [[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Auto generate on git push or got send]]%0a\ No newline at end of file%0a
30 85466e34 2023-02-28 jrmu host:1677414252=223.177.87.51
31 85466e34 2023-02-28 jrmu author:1677413951=fossdev
32 85466e34 2023-02-28 jrmu diff:1677413951:1677413778:=83c83%0a%3c '''NOTE''': Make sure you have properly configured the [[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] and with a [[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|entry]] for @@git@@ subdomain.%0a---%0a> '''NOTE''': Make sure you have properly configured the [[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] and has a [[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|entry]] for @@git@@ subdomain.%0a
33 85466e34 2023-02-28 jrmu host:1677413951=223.177.87.51
34 85466e34 2023-02-28 jrmu author:1677413778=fossdev
35 85466e34 2023-02-28 jrmu diff:1677413778:1677413778:=1,150d0%0a%3c This guide assumes you are familiar with git/[[https://wiki.ircnow.org/index.php?n=Got.Usage|got]] and the [[https://wiki.ircnow.org/index.php?n=Got.Repo|remote repositories]] are located at @@/var/www/got/public/@@. %0a%3c %0a%3c !!Overview%0a%3c %0a%3c [[https://codemadness.org/stagit.html|stagit]] is a simple static page generator for git.%0a%3c It generates static HTML pages for a git repository.%0a%3c %0a%3c !!!Advantages%0a%3c %0a%3c # It is written in C (with support for pledge and unveil).%0a%3c # The code base is very simple and is about 1.5K LOC.%0a%3c # Work very well with text-based browsers such as lynx and w3m.%0a%3c # No CGI or dynamic code is required.%0a%3c # No configuration required.%0a%3c # Atom feed of the commit and tags/refs.%0a%3c %0a%3c !!!Disadvantages%0a%3c %0a%3c # Depends on libgit2.%0a%3c # Not suitable for large repositories with many files, commits(2000+), or branches.%0a%3c # Does not support features like:%0a%3c ## Snapshot tarballs per commit.%0a%3c ## File tree per commit.%0a%3c ## History log of branches diverged from HEAD.%0a%3c ## Stats (git shortlog -s).%0a%3c # This is by design, just use git locally.%0a%3c %0a%3c !!Installation%0a%3c %0a%3c Install the dependency:%0a%3c %0a%3c [@%0a%3c $ doas pkg_add libgit2%0a%3c @]%0a%3c %0a%3c Get the latest release of stagit from [[https://codemadness.org/releases/stagit/|here]].%0a%3c At the time of writing, it was 1.2. %0a%3c %0a%3c [@%0a%3c $ ftp https://codemadness.org/releases/stagit/stagit-1.2.tar.gz%0a%3c $ ftp https://codemadness.org/releases/stagit/stagit-1.2.tar.gz.sha256%0a%3c $ sha256 -C stagit-1.2.tar.gz.sha256 stagit-1.2.tar.gz%0a%3c (SHA256) stagit-1.2.tar.gz: OK%0a%3c @]%0a%3c %0a%3c Extract, compile and install:%0a%3c %0a%3c [@%0a%3c $ tar xvzf stagit-1.2.tar.gz%0a%3c $ cd stagit-1.2%0a%3c $ make%0a%3c $ doas make install%0a%3c @]%0a%3c %0a%3c !!!Error on older libgit2%0a%3c %0a%3c If you get any error something like:%0a%3c %0a%3c [@%0a%3c cc -o stagit.o -c stagit.c -I/usr/local/include -O2 -pipe -D_XOPEN_SOURCE=700 -D_DEFAULT_SOURCE -D_BSD_SOURCE%0a%3c stagit.c:1239:19: error: use of undeclared identifier 'GIT_OPT_SET_OWNER_VALIDATION'%0a%3c git_libgit2_opts(GIT_OPT_SET_OWNER_VALIDATION, 0);%0a%3c ^%0a%3c 1 error generated.%0a%3c *** Error 1 in /home/fossdev/stagit-1.2 (Makefile:54 'stagit.o')%0a%3c @]%0a%3c %0a%3c Edit @@Makefile@@ and uncomment this line:%0a%3c %0a%3c [@%0a%3c STAGIT_CFLAGS += -DGIT_OPT_SET_OWNER_VALIDATION=-1%0a%3c @]%0a%3c %0a%3c Now you should be able make and install without any error.%0a%3c %0a%3c [@%0a%3c $ make%0a%3c $ doas make install%0a%3c @]%0a%3c %0a%3c !!Configuration%0a%3c %0a%3c '''NOTE''': Make sure you have properly configured the [[https://wiki.ircnow.org/index.php?n=Nsd.Configure|nsd]] and has a [[https://wiki.ircnow.org/index.php?n=Nsd.Zone?from=Openbsd.Dnszones|entry]] for @@git@@ subdomain.%0a%3c %0a%3c '''NOTE''': Replace example.com with your domain.%0a%3c %0a%3c Edit @@/etc/httpd.conf@@ and add this section.%0a%3c %0a%3c [@%0a%3c server "git.example.com" {%0a%3c listen on * port 80%0a%3c root "/htdocs/git.example.com"%0a%3c location "/.well-known/acme-challenge/*" {%0a%3c root "/acme"%0a%3c request strip 2%0a%3c }%0a%3c }%0a%3c @]%0a%3c %0a%3c If you want ssl/tls upport, you have to configure the acme-client and the relayd.%0a%3c %0a%3c !!Generate static site%0a%3c %0a%3c '''NOTE''': Replace example.com with your domain.%0a%3c %0a%3c [@%0a%3c # mkdir -p /var/www/htdocs/git.example.com%0a%3c # cd /var/www/htdocs/git.example.com%0a%3c @]%0a%3c %0a%3c '''NOTE''': Copy @@favicon.png@@, @@logo.png@@ and @@style.css@@ from stagit directory to @@/var/www/htdocs/git.example.com@@.%0a%3c %0a%3c [@%0a%3c # touch create.sh%0a%3c # chmod +x create.sh%0a%3c @]%0a%3c %0a%3c Edit create.sh and paste the code below:%0a%3c %0a%3c [@%0a%3c #!/bin/sh%0a%3c %0a%3c reposdir="/var/www/got/public"%0a%3c curdir="/var/www/htdocs/git.example.com"%0a%3c %0a%3c stagit-index "${reposdir}/"*/ > "${curdir}/index.html"%0a%3c %0a%3c for dir in "${reposdir}/"*/; do%0a%3c r=$(basename "${dir}")%0a%3c d=$(basename "${dir}" ".git")%0a%3c printf "%25s... " "${d}"%0a%3c %0a%3c mkdir -p "${curdir}/${d}"%0a%3c cd "${curdir}/${d}" || continue%0a%3c stagit -c ".cache" -u "https://git.example.com/$d/" "${reposdir}/${r}"%0a%3c %0a%3c ln -sf log.html index.html%0a%3c ln -sf ../style.css style.css%0a%3c ln -sf ../logo.png logo.png%0a%3c ln -sf ../favicon.png favicon.png%0a%3c %0a%3c echo "done"%0a%3c done%0a%3c @]%0a%3c %0a%3c Now you can visit @@http://git.example.com@@.%0a%3c %0a%3c '''NOTE''': You can replace the default @@favicon.png@@ and @@logo.png@@ with your 32x32 logo.%0a%3c %0a%3c Next: [[https://wiki.ircnow.org/index.php?n=Stagit.AutoGenerate|Auto generate on git push or got send]]%0a\ No newline at end of file%0a
36 85466e34 2023-02-28 jrmu host:1677413778=223.177.87.51
