summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFriedrich Beckmann <friedrich.beckmann@gmx.de>2025-06-19 14:23:50 +0200
committerFriedrich Beckmann <friedrich.beckmann@gmx.de>2025-06-19 14:34:01 +0200
commit96c01286f2451283b848abc22fe1602c5b263673 (patch)
tree48e4c94545fc982b879b03b0df5e97ca5e1a8dbc
parente6c6f2ca7ae0e4c4a557c2c124e5f2c02054847c (diff)
help.md: added git info and changed the upload rsync command
-rw-r--r--content/help.md60
1 files changed, 48 insertions, 12 deletions
diff --git a/content/help.md b/content/help.md
index 7fcce25..0d1f3f1 100644
--- a/content/help.md
+++ b/content/help.md
@@ -10,21 +10,29 @@ This website is rendered as static html with [hugo](https://gohugo.io). The Sill
# Test the website
-#### Install hugo via homebrew
+#### Install hugo and rsync via homebrew
-You need the hugo software to render the website. The software is available via [homebrew](https://brew.sh).
+You need the hugo software to render the website. The software is available via [homebrew](https://brew.sh). The rsync software is used to transfer the web data to the webserver.
```
-brew install hugo
+brew install hugo rsync
```
-#### Download the git repository
+#### Download or update the git repository
+
+If you run this the first time, you need to download the git repository with the following command:
```
cd
git clone https://caeis.etech.fh-augsburg.de/beckmanf/sillab.git
```
+If you have the repository already on your computer, just update to see if some changes are on the server that you have not.
+
+```
+git pull
+```
+
#### Run the hugo test server
```
@@ -116,20 +124,48 @@ The "hugo build" command will compile the static html files and copy them togeth
hugo build
```
-#### Fix file permissions
+#### Upload the files to the webserver
+
+Copy the files in the folder "public" via "rsync" to the webserver.
-You need to make sure that all files in "public" folder are accessible for group and others.
```
-cd
-cd sillab
-chmod -R go+r public
+/opt/homebrew/bin/rsync -rphv --chmod=D775,F664 --groupmap=*:www --delete public/ silke@fredowski.duckdns.org:/var/www
```
-#### Upload the files
+#### Upload your changes to the git repository
-Copy the files in the folder "public" via "rsync" to the webserver.
+Assume you have added a post by creating a new markdown file "posts/shadesofblue/220631-lecoq.md" with a new image file "assets/img/silkepiano.jpg". You can see which files you have changed and which you have added with:
```
-rsync -avhP --delete public/* fritz@fredowski.duckdns.org:/var/www
+git status
```
+which will tell you that there are these two new "untracked" files. You add the two new files to the next "commit" with
+
+```
+git add assets/img/silkepiano.jpg
+git add posts/shadesofblue/220631-leqoq.md
+```
+
+You do the same when you just change files. Then you make a commit with
+
+```
+git commit
+```
+
+which opens an editor. You write a comment what this commit is about like "added show in Le Coq". When you exit the editor, the commit is added to the git database. See:
+
+```
+git log
+```
+
+Now you upload the changes to the git server with
+
+```
+git push
+```
+
+You can then see your commit on the server
+
+https://caeis.etech.fh-augsburg.de/beckmanf/sillab.git/log/
+