index.html (7651B)
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