documentation/gollum.md
... ...
@@ -6,6 +6,16 @@ gem install gollum
6 6
gem install github-markdown #required for tables
7 7
```
8 8
9
+navigate to wiki dir and run gollum
10
+```
11
+gollum --css --h1-title
12
+```
13
+- using custom css file and setting first h1 header as page title
14
+- see [gollum config][] docs for options
15
+- look at [omnigollum][] for user auth
16
+- [gollum reverse proxy][]
17
+
18
+## running as a service
9 19
enter the following in `/etc/systemd/system/gollum-personal.service`
10 20
```
11 21
[Unit]
... ...
@@ -20,3 +30,70 @@ Restart=on-abort
20 30
[Install]
21 31
WantedBy=multi-user.target
22 32
```
33
+
34
+## installing gollum on jump-test
35
+https://github.com/gollum/gollum # use --bare
36
+
37
+- configure omnigollum https://github.com/arr2036/omnigollum
38
+- using azuread https://github.com/AzureAD/omniauth-azure-activedirectory
39
+
40
+### steps
41
+- to enable [git server][]
42
+ - install git (duh!)
43
+ - create 'git' user
44
+ ```
45
+ adduser git
46
+ mkdir ~git/.ssh
47
+ chmod 700 ~git/.ssh
48
+ touch ~git/.ssh/authorized_keys
49
+ chmod 600 ~git/.ssh/authorized_keys
50
+ ```
51
+- mkdir 'wiki' dir
52
+ ```
53
+ mkdir /wiki
54
+ chown git. /wiki
55
+ ```
56
+- create git repo - [getting git on server][]
57
+ ```
58
+ su - git
59
+ cd /wiki
60
+ git init --bare --shared
61
+ ```
62
+- clone repo and initial commit (on local machine)
63
+ ```
64
+ git clone git@gitserver:/wiki wiki
65
+ cd wiki/
66
+ echo "# wiki" > README.md
67
+ git add README.md
68
+ git commit -m "Initial commit"
69
+ git push -u origin master
70
+ ```
71
+- install gollum
72
+ ```
73
+ apt install ruby ruby-dev build-essential zlib1g-dev libicu-dev
74
+ gem install gollum
75
+ ```
76
+
77
+ ```
78
+ yum group install "Development Tools"
79
+ yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel
80
+ gem install gollum
81
+ ```
82
+- enable gollum as a service
83
+ ```
84
+ vi /etc/systemd/system/gollum.service
85
+
86
+ [Service]
87
+ ExecStart=/usr/local/bin/gollum --show-all "/wiki"
88
+ ```
89
+- allow traffic
90
+ ```
91
+ iptables -I INPUT -p tcp --dport 4567 -j ACCEPT -m comment --comment "Allow access to wiki"
92
+ ```
93
+
94
+## ref
95
+[gollum config]: https://github.com/gollum/gollum#configuration
96
+[omnigollum]: https://github.com/arr2036/omnigollum/blob/master/config.rb.example
97
+[gollum reverse proxy]: https://gist.github.com/spinpx/c46ea0b24157ca5f731f
98
+[git server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Setting-Up-the-Server
99
+[getting git on server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Getting-Git-on-a-Server
documentation/vimwiki.md
... ...
@@ -27,89 +27,5 @@ pandoc -s -f markdown -t html -o uofu/azure_ad_requirements.html uofu/azure_ad_r
27 27
i'm using :tags: under a #ref header to jump to links in page
28 28
- switch to [pandoc markdown][]
29 29
30
-## gollum
31
-- install gollum
32
- ```
33
- sudo gem install gollum
34
- ```
35
- - requires 'icu'
36
- ```
37
- sudo dnf install libicu-devel
38
- ```
39
-- navigate to wiki dir and run gollum
40
- ```
41
- gollum --css --h1-title
42
- ```
43
- - using custom css file and setting first h1 header as page title
44
- - see [gollum config][] docs for options
45
-- look at [omnigollum][] for user auth
46
-- [gollum reverse proxy][]
47
-
48
-## installing gollum on jump-test
49
-https://github.com/gollum/gollum # use --bare
50
-
51
-- configure omnigollum https://github.com/arr2036/omnigollum
52
-- using azuread https://github.com/AzureAD/omniauth-azure-activedirectory
53
-
54
-### steps
55
-- to enable [git server][]
56
- - install git (duh!)
57
- - create 'git' user
58
- ```
59
- adduser git
60
- mkdir ~git/.ssh
61
- chmod 700 ~git/.ssh
62
- touch ~git/.ssh/authorized_keys
63
- chmod 600 ~git/.ssh/authorized_keys
64
- ```
65
-- mkdir 'wiki' dir
66
- ```
67
- mkdir /wiki
68
- chown git. /wiki
69
- ```
70
-- create git repo - [getting git on server][]
71
- ```
72
- su - git
73
- cd /wiki
74
- git init --bare --shared
75
- ```
76
-- clone repo and initial commit (on local machine)
77
- ```
78
- git clone git@gitserver:/wiki wiki
79
- cd wiki/
80
- echo "# wiki" > README.md
81
- git add README.md
82
- git commit -m "Initial commit"
83
- git push -u origin master
84
- ```
85
-- install gollum
86
- ```
87
- apt install ruby ruby-dev build-essential zlib1g-dev libicu-dev
88
- gem install gollum
89
- ```
90
-
91
- ```
92
- yum group install "Development Tools"
93
- yum install ruby ruby-devel libicu libicu-devel zlib zlib-devel
94
- gem install gollum
95
- ```
96
-- enable gollum as a service
97
- ```
98
- vi /etc/systemd/system/gollum.service
99
-
100
- [Service]
101
- ExecStart=/usr/local/bin/gollum --show-all "/wiki"
102
- ```
103
-- allow traffic
104
- ```
105
- iptables -I INPUT -p tcp --dport 4567 -j ACCEPT -m comment --comment "Allow access to wiki"
106
- ```
107
-
108
-
109 30
## ref
110 31
[pandoc markdown]: http://pandoc.org/MANUAL.html#pandocs-markdown
111
-[gollum config]: https://github.com/gollum/gollum#configuration
112
-[omnigollum]: https://github.com/arr2036/omnigollum/blob/master/config.rb.example
113
-[gollum reverse proxy]: https://gist.github.com/spinpx/c46ea0b24157ca5f731f
114
-[git server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Setting-Up-the-Server
115
-[getting git on server]: https://git-scm.com/book/en/v2/Git-on-the-Server-Getting-Git-on-a-Server