06e8b8c3c39a445a1265671a58f867a3c6b0184f
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 |