permacomputing

commit 7d1c48aa8ba06286801f602ca7383d530511e7c8
parent 5d3d7014fb15ed27ac5de4332c4b012ec38de401
Author: ugrnm <ultrageranium@bleu255.com>
Date:   Tue, 15 Oct 2024 19:57:18 +0200

docs: git hosting update with helper script

Diffstat:
M
eik.mdwn
 | 
20
+++++++++++++-------

1 file changed, 13 insertions(+), 7 deletions(-)
diff --git a/eik.mdwn b/eik.mdwn
@@ -83,15 +83,23 @@ git hosting
 
 Git repositories are located in `/var/www/git.permacomputing.net/repos`. Any user in the `gitusers` group has access to reading and writing these files.
 
-*  to add a user to the group (replacing `USERNAME` as needed): 
+*  to add a new eik user to the group (replacing `USERNAME` as needed): 
 
    ```usermod --append --groups gitusers USERNAME```
 
-*  to create a new repository (via ssh, replacing `USERNAME` and `REPONAME`): 
+*  to create a new repository on eik (replacing `USERNAME` and `REPONAME`): 
 
    ```
-   ssh USERNAME@eik \
-     "git init --bare /var/www/git.permacomputing.net/repos/REPONAME.git"
+   ssh USERNAME@eik
+   cd /var/www/git.permacomputing.net
+   ./new_repos.sh REPONAME "one line about the repos"
+   ```
+
+*  to clone (locally) your new repo:
+
+   ```
+   git config --global init.defaultBranch main  # if not done already
+   git clone USERNAME@eik:/var/www/git.permacomputing.net/repos/REPONAME.git
    ```
 
 *  to add a repository as a git remote (for `git push`, replacing `USERNAME` and `REPONAME`):
@@ -106,9 +114,7 @@ stagit
 
 [stagit](https://codemadness.org/stagit.html) is used to produce the staticly generated web interface that is [git.permacomputing.net](https://git.permacomputing.net).
 
-If you follow the instructions above ("git hosting") to add a new git repository, you then need to run `/var/www/git.permacomputing.net/update_all.sh` to regenerate the html.
-
-You can configure metadata for each repository in the `/var/www/permacomputing.net/repos/REPONAME.git` directory. See `man stagit` for more.
+If you follow the instructions above ("git hosting") to add a new git repository, then all the needed hooks and git repo modifications have been installed. Next time you push, you should see your changes reflected on http://git.permacomputing.net and http://git.permacomputing.net/REPO.
 
 home pages
 ----------