main
1<!DOCTYPE html>
2
3<html lang="fr">
4
5 <head>
6 <meta charset="utf-8">
7 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
8
9 <link rel="start" href="https://vincent.demeester.fr" />
10
11 <title>Vincent Demeester</title>
12 <link rel="canonical" href="https://vincent.demeester.fr/posts/2012-12-16-gollum-comme-wiki-personnel/">
13 <link href="https://vincent.demeester.fr/index.xml" rel="alternate" type="application/rss+xml" title="Vincent Demeester" />
14
15 <link rel="openid.server" href="https://indieauth.com/openid" />
16 <link rel="openid.delegate" href="http://vincent.demeester.fr/" />
17 <link rel="shortcut icon" type="image/x-icon" href="favicon.ico">
18
19 <link rel="stylesheet" href="/css/screen.css" type="text/css" />
20 <link rel="stylesheet" href="/css/sbrain.css" type="text/css" />
21 <link rel="stylesheet" href="/css/syntax.css" type="text/css" />
22
23 </head>
24
25 <body lang="fr" class="gray">
26
27
28
29
30
31
32<div id="main-container">
33 <div id="page">
34 <article class="post">
35 <header>
36 <h1 class="emphnext">Gollum Comme Wiki Personnel</h1><a href='https://vincent.demeester.fr/posts/2012-12-16-gollum-comme-wiki-personnel/'></a>
37 <address class="signature">
38 <span class="date">Sun, 16 December, 2012</span>
39 <span class="words">(500 Words)</span>
40 </address>
41 <ul class="tag_box inline">
42
43 <li class="category"><a href="/categories/#me">me</a></li>
44
45
46
47
48
49 <li class="tag tag-wiki"><a href="/tags/#wiki">wiki<span>1</span></a></li>
50
51
52 <li class="tag tag-gollum"><a href="/tags/#gollum">gollum<span>1</span></a></li>
53
54
55 <li class="tag tag-github"><a href="/tags/#github">github<span>2</span></a></li>
56
57
58 <li class="tag tag-personnel"><a href="/tags/#personnel">personnel<span>1</span></a></li>
59
60 <br/>
61
62 </ul>
63 </header>
64
65
66
67
68
69<p>Il y a environ 4 mois j’ai eu un accident de vélo ; un traumatisme crânien, des brulures sur la face, quelques points de sutures, un doigt cassé et une hernie discale m’ont cloué (et me clou encore) plus que d’habitude sur ma chaise de bureau. Le bon côté des choses, c’est que cela m’a permit de me poser et de réfléchir une bonne façon d’être efficace et organiser, au travail et à la maison :-).</p>
70
71<p>Une des principales <em>action</em> que j’ai pris est d’utiliser un wiki local et synchronisé sur <em>tout</em> mes PCs. Le <em>format</em> wiki est assez adapté à une prise de note et à la création de contenu plus complet (comme des <a href="http://shortbrain.org">articles</a> ou de la documentation pour des projets en cours). Les conditions étaient les suivantes :</p>
72
73<ul>
74<li>Facilité de mise en place.</li>
75<li>Pas de base de données.</li>
76<li><em>Merging</em> facile (<a href="http://git-scm.com">git</a> <em>rules my world</em>).</li>
77<li><a href="http://daringfireball.net/projects/markdown/">Markdown</a> comme syntaxe, car utilisé à peu près partout (blogs, articles, READMEs, documentations).</li>
78<li>Éditable à partir d’une interface web ou de mon éditeur favoris.</li>
79</ul>
80
81<p>L’outil qui remplit presque toutes ces conditions s’appelle <a href="https://github.com/github/gollum">gollum</a>. C’est un moteur wiki, écris en ruby, qui se base sur un repository <a href="http://git-scm.com">git</a>. Il est développer par l’équipe de <a href="http://github.com">Github</a> et c’est celui qui est utilisé par les pages wiki là-bas. Il permet d’utiliser à peu près n’importe quel syntaxe (dont <a href="https://github.com/github/github-flavored-markdown">github-markdown</a> qui est assez proche de celle de <a href="http://johnmacfarlane.net/pandoc">pandoc</a>). Par ailleurs, comme il se base sur <a href="http://git-scm.com">git</a>, les points <em>“pas de base de données”</em>, <em>“merging facile”</em> et <em>“éditable également à partir de mon éditeur favoris”</em> sont toutes remplies.</p>
82
83<p>Avec <a href="https://github.com/github/gollum">Gollum</a> vous avez un wiki markdown décentralisé, éditable via une interface web ou via votre éditeur favoris.</p>
84
85<h2 id="mise-en-place">Mise en place</h2>
86
87<p>La mise en place est relativement simple ; après tout dépend du besoin que vous avez. L’installation se fait par <a href="rubygems.org">RubyGem</a> ou en clonant le repository.</p>
88
89<div class="highlight"><pre class="chroma"><code class="language-bash" data-lang="bash"><span class="c1"># Installation de gollum et du format markdown de github</span>
90$ gem install gollum gitub-markdown</code></pre></div>
91
92<p>Si vous n’utilisez pas <a href="https://github.com/sstephenson/rbenv">rbenv</a> ou <a href="https://rvm.io/">rvm</a> il est probable qu’il faille lancer la commande en root ou utiliser sudo.</p>
93
94<p>Ensuite, il suffit de lancer <a href="https://github.com/github/gollum">Gollum</a> dans un dossier qui est un repository git ; le tour est joué</p>
95
96<div class="highlight"><pre class="chroma"><code class="language-bash" data-lang="bash"><span class="c1"># J'ulitise ~/desktop/wiki pour mon wiki</span>
97$ <span class="nb">cd</span> ~/desktop/wiki <span class="o">&&</span> gollum</code></pre></div>
98
99<p>L’idée finale est d’automatiser deux choses :</p>
100
101<ol>
102<li>Le démarrage de gollum</li>
103<li>La synchronisation du repository avec les différents autres <em>remotes</em></li>
104</ol>
105
106<p>Suivant le système d’exploitation et/ou la distribution utilisées, il y a énormément de possibilité d’effectuer cette automatisation. Dans mon cas, j’ai une <a href="http://debian.org">Debian</a> assez light, avec surtout plein de scripts. Je démarre donc <a href="https://github.com/github/gollum">Gollum</a> au démarrage de ma session grâce à une script qui est lancé dans la foulée du gestionnaire de fenêtre. La synchronisation se fait grâce à une tâche planifiée <em>cron</em> qui est “distribué” sur chacune de mes machines.</p>
107
108<p><em>C’est tout pour le moment</em> ;-).</p>
109
110
111 </article>
112 <hr />
113 <div class="prev-next">
114
115 <a class="paging-link prev" href="/posts/2013-09-08-maven-tmpfs/" title="Maven Tmpfs">← Previous post</a>
116
117
118
119 <a class="paging-link next" href="/posts/2012-07-23-maven-release-gitflow/" title="Maven Release Gitflow">Next post →</a>
120
121 </div>
122
123 </div>
124</div>
125
126<footer>
127 <nav>
128
129 <a href="/">home</a>
130 <span class="text-muted"> | </span>
131
132 <a href="/about">about</a>
133 <span class="text-muted"> | </span>
134
135 <a href="/archive">archive</a>
136 <span class="text-muted"> | </span>
137
138 <a href="/categories">categories</a>
139 <span class="text-muted"> | </span>
140
141 <a href="/tags">tags</a>
142 <span class="text-muted"> | </span>
143
144 <a href="https://twitter.com/vdemeest">twitter</a>
145 <span class="text-muted"> | </span>
146
147 <a href="https://github.com/vdemeester">github</a>
148 <span class="text-muted"> | </span>
149
150 <a href="https://vincent.demeester.fr/index.xml">rss</a>
151 </nav>
152 <br/>
153 <address>
154 <span class="copyright">
155 Content and design by Vincent Demeester
156 (<a rel="licence" href="http://creativecommons.org/licenses/by-nc-sa/3.0/">Some rights reserved</a>)
157 </span><br />
158 <span class="engine">
159 Powered by <a href="https://gohugo.io/">Hugo</a> and <a href="https://github.com/kaushalmodi/ox-hugo/">ox-hugo</a>
160 </span>
161 </address>
162</footer>
163</body>
164