mirror of
https://github.com/almet/notmyidea.git
synced 2025-04-28 19:42:37 +02:00
Update documentation
This commit is contained in:
Daniel Atwood.
parent
b69cb26fa6
commit
3622b1f0b1
7 changed files with 65 additions and 64 deletions
16
author/.html
16
author/.html
|
|
@ -85,10 +85,6 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Journal</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/prendre-le-temps.html">Prendre le temps</a>
|
||||
|
|
@ -113,6 +109,10 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/prix-libre-et-conscient.html">Prix libre et conscient & culpabilisation</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/ecran-et-dependances.html">Écran et dépendances</a>
|
||||
</li>
|
||||
<li><span class="metadata date">…</span><a class="post_title" href="/category/journal.html">plus d'articles </a> </li></ul>
|
||||
|
||||
<ul class="articles_list">
|
||||
|
|
@ -121,6 +121,10 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Notes</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/assurance-chomage.html">Assurance chômage</a>
|
||||
|
|
@ -145,10 +149,6 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<span class="metadata date">juin 2013</span>
|
||||
<a class="post_title" href="/notes-economie-libidinale-et-economie-politique.html">Notes: Économie libidinale et économie politique</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">mars 2013</span>
|
||||
<a class="post_title" href="/le-revenu-de-base.html">Le revenu de base</a>
|
||||
</li>
|
||||
<li><span class="metadata date">…</span><a class="post_title" href="/category/notes.html">plus d'articles </a> </li></ul>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -52,10 +52,6 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<div class="posts">
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Journal</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
<span class="metadata category">Journal</span> </li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/prendre-le-temps.html">Prendre le temps</a>
|
||||
|
|
|
|||
|
|
@ -52,6 +52,10 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<div class="posts">
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Notes</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
<span class="metadata category">Notes</span> </li>
|
||||
<li>
|
||||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/assurance-chomage.html">Assurance chômage</a>
|
||||
|
|
|
|||
|
|
@ -1,45 +1,5 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<feed xmlns="http://www.w3.org/2005/Atom"><title>Carnets en ligne - Journal</title><link href="https://blog.notmyidea.org/" rel="alternate"></link><link href="https://blog.notmyidea.org/feeds/journal.atom.xml" rel="self"></link><id>https://blog.notmyidea.org/</id><updated>2020-01-14T00:00:00+01:00</updated><entry><title>Packager pour Debian</title><link href="https://blog.notmyidea.org/packager-pour-debian.html" rel="alternate"></link><published>2020-01-14T00:00:00+01:00</published><updated>2020-01-14T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2020-01-14:/packager-pour-debian.html</id><summary type="html">
|
||||
<p>Aujourd'hui j'ai fais un peu de packaging pour la distribution Linux Debian, avec l'aide d'un ami. C'était assez agréable de pouvoir me faire aider dans cet objectif : j'avais déjà tenté l'expérience en solo par le passé, et m'étais cassé les dents sur le sujet.</p>
|
||||
<p>Voici quelques notes prises durant l'après-midi …</p></summary><content type="html">
|
||||
<p>Aujourd'hui j'ai fais un peu de packaging pour la distribution Linux Debian, avec l'aide d'un ami. C'était assez agréable de pouvoir me faire aider dans cet objectif : j'avais déjà tenté l'expérience en solo par le passé, et m'étais cassé les dents sur le sujet.</p>
|
||||
<p>Voici quelques notes prises durant l'après-midi, qui pourront sans doute me servir pour la suite.</p>
|
||||
<h2 id="quest-ce-quon-fait">Qu'est-ce qu'on fait ?</h2>
|
||||
<p>On essaye de créer un paquet Debian pour une application Web écrite en python. Il s'agit d'une application assez simple, qui communique avec une base de données d'un côté, et avec des utilisateurs de l'autre.</p>
|
||||
<h2 id="y-aller-par-etapes">Y aller par étapes</h2>
|
||||
<p>On a essayé de faire en sorte d'avoir quelque chose de fonctionnel assez rapidement, même si pas entièrement fait dans les règles de l'art. Ça à l'avantage de garder la motivation :-)</p>
|
||||
<ol>
|
||||
<li>Produire un paquet <code>.deb</code> qui peut s'installer, et qui fait tourner l'application en question ;</li>
|
||||
<li>Avoir un paquet qui passe les règles de validation de Debian ;</li>
|
||||
<li>Intégrer le paquet avec <code>systemd</code> ;</li>
|
||||
<li>Intégrer le paquet dans un système de contrôle de version type git ;</li>
|
||||
</ol>
|
||||
<h2 id="packaging-simple-1ere-version-fonctionnelle">Packaging « simple » - 1ère version fonctionnelle</h2>
|
||||
<p>On commence par faire un paquet dit « natif ». C'est l'approche la plus simple.
|
||||
Deux fichiers sont importants, pour commencer : <code>control</code> et <code>changelog</code>. Le fichier <code>control</code> contient un bloc « source » et un ou plusieurs blocs « package », dans l'idée de pouvoir avoir potentiellement plusieurs paquets binaires générés à partir du même package source, ce qui est utile pour les gros paquets.</p>
|
||||
<p>Voici les étapes qu'on a suivi :</p>
|
||||
<ol>
|
||||
<li>Créer les fichiers <code>control</code>, <code>changelog</code> et <code>rules</code> dans le répertoire <code>debian</code>. Dans la pratique on peut les copier depuis un autre paquet qu'on prends comme modèle ;</li>
|
||||
<li>Installer les dépendances de build avec <code>sudo apt install devscripts &amp;&amp; mk-build-deps -i -r --root-cmd sudo</code> ;</li>
|
||||
<li>Lancer <code>dpkg-buildpackage -rfakeroot</code> qui va construire le paquet pour nous ;</li>
|
||||
<li>Regarder la sortie de la commande pour voir les dépendances qui ne sont pas déjà prêtes pour Debian ;</li>
|
||||
<li>Pour les quelques dépendances qui n'étaient pas déjà prêtes, on a répété les étapes précédentes.</li>
|
||||
</ol>
|
||||
<h2 id="questions-diverses-observations">Questions diverses &amp; observations</h2>
|
||||
<p><code>dh-helper</code> est une manière de packager « officiellement recommandée », il s'agit d'un ensemble d'outils qui cherchent à se faciliter la tache de <em>packaging</em>.</p>
|
||||
<p>Pour les traductions : il n'est pas nécessaire de faire des paquets séparés pour la traduction, c'est acceptable de tout mettre dans le même paquet.</p>
|
||||
<p>La documentation peut elle aussi être intégrée dans le même paquet.</p>
|
||||
<p>Pour les numéros de version, si on a pas de tiret dans le numéro de version, alors il s'agit de la version <em>upstream</em>. Si on a un tiret, ce qui est après le numéro de version est la version du <em>packaging</em> pour Debian.</p>
|
||||
<p><code>DEB_BUILD_OPTIONS=nocheck</code> permet de ne pas avoir à lancer les tests à chaque fois qu'on construit le paquet.</p>
|
||||
<h2 id="etapes-dapres">Étapes d'après</h2>
|
||||
<ul>
|
||||
<li>Peut-être utiliser<code>debian/missing-sources</code>, en tout cas régler le souci pour les bibliothèques JavaScript et le CSS dont les sources ne sont pas distribuées actuellement (parce que versions minifiées).</li>
|
||||
<li>Il est possible d'installer des dépendances et de spécifier des liens symboliques à créer lors de l'installation.</li>
|
||||
<li>Intégrer de la documentation sous forme de <code>manpage</code>. Il semble que certains outils permettent de le faire de manière simple / automatique, comme « help2man »</li>
|
||||
<li>De la même manière qu'on le fait pour les ressources type JS et CSS, il faut intégrer les <em>fonts</em>, en faisant référence aux fonts empaquetées pour Debian. </li>
|
||||
<li>Une fois que tout ça fonctionne, passer à un système de build qui comprends git</li>
|
||||
<li>Faire une intégration avec <code>systemd</code> pour avoir un service qui se lance automatiquement. Ce qui veut aussi dire créer un utilisateur spécifique pour notre service.</li>
|
||||
</ul></content></entry><entry><title>Prendre le temps</title><link href="https://blog.notmyidea.org/prendre-le-temps.html" rel="alternate"></link><published>2020-01-14T00:00:00+01:00</published><updated>2020-01-14T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2020-01-14:/prendre-le-temps.html</id><summary type="html"><h2 id="prendre-le-temps">Prendre le temps</h2>
|
||||
<feed xmlns="http://www.w3.org/2005/Atom"><title>Carnets en ligne - Journal</title><link href="https://blog.notmyidea.org/" rel="alternate"></link><link href="https://blog.notmyidea.org/feeds/journal.atom.xml" rel="self"></link><id>https://blog.notmyidea.org/</id><updated>2020-01-14T00:00:00+01:00</updated><entry><title>Prendre le temps</title><link href="https://blog.notmyidea.org/prendre-le-temps.html" rel="alternate"></link><published>2020-01-14T00:00:00+01:00</published><updated>2020-01-14T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2020-01-14:/prendre-le-temps.html</id><summary type="html"><h2 id="prendre-le-temps">Prendre le temps</h2>
|
||||
<p>Jusqu'ici, j'ai souvent eu l'impression que le temps s'écoulait sans que je puisse avoir de prise dessus.</p>
|
||||
<p>Depuis peu, je me rends compte que j'ai l'opportunité de « visiter » ce flux, de — quelque part — « naviguer » en son sein, et que ce faisant, il se densifie, il prends plus …</p></summary><content type="html"><h2 id="prendre-le-temps">Prendre le temps</h2>
|
||||
<p>Jusqu'ici, j'ai souvent eu l'impression que le temps s'écoulait sans que je puisse avoir de prise dessus.</p>
|
||||
|
|
|
|||
|
|
@ -1,5 +1,45 @@
|
|||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<feed xmlns="http://www.w3.org/2005/Atom"><title>Carnets en ligne - Notes</title><link href="https://blog.notmyidea.org/" rel="alternate"></link><link href="https://blog.notmyidea.org/feeds/notes.atom.xml" rel="self"></link><id>https://blog.notmyidea.org/</id><updated>2019-12-13T00:00:00+01:00</updated><entry><title>Assurance chômage</title><link href="https://blog.notmyidea.org/assurance-chomage.html" rel="alternate"></link><published>2019-12-13T00:00:00+01:00</published><updated>2019-12-13T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2019-12-13:/assurance-chomage.html</id><summary type="html">
|
||||
<feed xmlns="http://www.w3.org/2005/Atom"><title>Carnets en ligne - Notes</title><link href="https://blog.notmyidea.org/" rel="alternate"></link><link href="https://blog.notmyidea.org/feeds/notes.atom.xml" rel="self"></link><id>https://blog.notmyidea.org/</id><updated>2020-01-14T00:00:00+01:00</updated><entry><title>Packager pour Debian</title><link href="https://blog.notmyidea.org/packager-pour-debian.html" rel="alternate"></link><published>2020-01-14T00:00:00+01:00</published><updated>2020-01-14T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2020-01-14:/packager-pour-debian.html</id><summary type="html">
|
||||
<p>Aujourd'hui j'ai fais un peu de packaging pour la distribution Linux Debian, avec l'aide d'un ami. C'était assez agréable de pouvoir me faire aider dans cet objectif : j'avais déjà tenté l'expérience en solo par le passé, et m'étais cassé les dents sur le sujet.</p>
|
||||
<p>Voici quelques notes prises durant l'après-midi …</p></summary><content type="html">
|
||||
<p>Aujourd'hui j'ai fais un peu de packaging pour la distribution Linux Debian, avec l'aide d'un ami. C'était assez agréable de pouvoir me faire aider dans cet objectif : j'avais déjà tenté l'expérience en solo par le passé, et m'étais cassé les dents sur le sujet.</p>
|
||||
<p>Voici quelques notes prises durant l'après-midi, qui pourront sans doute me servir pour la suite.</p>
|
||||
<h2 id="quest-ce-quon-fait">Qu'est-ce qu'on fait ?</h2>
|
||||
<p>On essaye de créer un paquet Debian pour une application Web écrite en python. Il s'agit d'une application assez simple, qui communique avec une base de données d'un côté, et avec des utilisateurs de l'autre.</p>
|
||||
<h2 id="y-aller-par-etapes">Y aller par étapes</h2>
|
||||
<p>On a essayé de faire en sorte d'avoir quelque chose de fonctionnel assez rapidement, même si pas entièrement fait dans les règles de l'art. Ça à l'avantage de garder la motivation :-)</p>
|
||||
<ol>
|
||||
<li>Produire un paquet <code>.deb</code> qui peut s'installer, et qui fait tourner l'application en question ;</li>
|
||||
<li>Avoir un paquet qui passe les règles de validation de Debian ;</li>
|
||||
<li>Intégrer le paquet avec <code>systemd</code> ;</li>
|
||||
<li>Intégrer le paquet dans un système de contrôle de version type git ;</li>
|
||||
</ol>
|
||||
<h2 id="packaging-simple-1ere-version-fonctionnelle">Packaging « simple » - 1ère version fonctionnelle</h2>
|
||||
<p>On commence par faire un paquet dit « natif ». C'est l'approche la plus simple.
|
||||
Deux fichiers sont importants, pour commencer : <code>control</code> et <code>changelog</code>. Le fichier <code>control</code> contient un bloc « source » et un ou plusieurs blocs « package », dans l'idée de pouvoir avoir potentiellement plusieurs paquets binaires générés à partir du même package source, ce qui est utile pour les gros paquets.</p>
|
||||
<p>Voici les étapes qu'on a suivi :</p>
|
||||
<ol>
|
||||
<li>Créer les fichiers <code>control</code>, <code>changelog</code> et <code>rules</code> dans le répertoire <code>debian</code>. Dans la pratique on peut les copier depuis un autre paquet qu'on prends comme modèle ;</li>
|
||||
<li>Installer les dépendances de build avec <code>sudo apt install devscripts &amp;&amp; mk-build-deps -i -r --root-cmd sudo</code> ;</li>
|
||||
<li>Lancer <code>dpkg-buildpackage -rfakeroot</code> qui va construire le paquet pour nous ;</li>
|
||||
<li>Regarder la sortie de la commande pour voir les dépendances qui ne sont pas déjà prêtes pour Debian ;</li>
|
||||
<li>Pour les quelques dépendances qui n'étaient pas déjà prêtes, on a répété les étapes précédentes.</li>
|
||||
</ol>
|
||||
<h2 id="questions-diverses-observations">Questions diverses &amp; observations</h2>
|
||||
<p><code>dh-helper</code> est une manière de packager « officiellement recommandée », il s'agit d'un ensemble d'outils qui cherchent à se faciliter la tache de <em>packaging</em>.</p>
|
||||
<p>Pour les traductions : il n'est pas nécessaire de faire des paquets séparés pour la traduction, c'est acceptable de tout mettre dans le même paquet.</p>
|
||||
<p>La documentation peut elle aussi être intégrée dans le même paquet.</p>
|
||||
<p>Pour les numéros de version, si on a pas de tiret dans le numéro de version, alors il s'agit de la version <em>upstream</em>. Si on a un tiret, ce qui est après le numéro de version est la version du <em>packaging</em> pour Debian.</p>
|
||||
<p><code>DEB_BUILD_OPTIONS=nocheck</code> permet de ne pas avoir à lancer les tests à chaque fois qu'on construit le paquet.</p>
|
||||
<h2 id="etapes-dapres">Étapes d'après</h2>
|
||||
<ul>
|
||||
<li>Peut-être utiliser<code>debian/missing-sources</code>, en tout cas régler le souci pour les bibliothèques JavaScript et le CSS dont les sources ne sont pas distribuées actuellement (parce que versions minifiées).</li>
|
||||
<li>Il est possible d'installer des dépendances et de spécifier des liens symboliques à créer lors de l'installation.</li>
|
||||
<li>Intégrer de la documentation sous forme de <code>manpage</code>. Il semble que certains outils permettent de le faire de manière simple / automatique, comme « help2man »</li>
|
||||
<li>De la même manière qu'on le fait pour les ressources type JS et CSS, il faut intégrer les <em>fonts</em>, en faisant référence aux fonts empaquetées pour Debian. </li>
|
||||
<li>Une fois que tout ça fonctionne, passer à un système de build qui comprends git</li>
|
||||
<li>Faire une intégration avec <code>systemd</code> pour avoir un service qui se lance automatiquement. Ce qui veut aussi dire créer un utilisateur spécifique pour notre service.</li>
|
||||
</ul></content></entry><entry><title>Assurance chômage</title><link href="https://blog.notmyidea.org/assurance-chomage.html" rel="alternate"></link><published>2019-12-13T00:00:00+01:00</published><updated>2019-12-13T00:00:00+01:00</updated><author><name></name></author><id>tag:blog.notmyidea.org,2019-12-13:/assurance-chomage.html</id><summary type="html">
|
||||
<p>Depuis une génération, les durées et les montants d'indemnisation ont régulièrement diminué en France, par étapes successives, ce qui fait que bon nombre de salariés n'ont pas conscience qu'il ne seront indemnisés à 57 % de leur ex-salaire en cas de chômage, et pour seulement deux ans, alors que les personnes …</p></summary><content type="html">
|
||||
<p>Depuis une génération, les durées et les montants d'indemnisation ont régulièrement diminué en France, par étapes successives, ce qui fait que bon nombre de salariés n'ont pas conscience qu'il ne seront indemnisés à 57 % de leur ex-salaire en cas de chômage, et pour seulement deux ans, alors que les personnes de la génération précédente l'on été pendant trois ans à 75 % ou 80 % de leur ex-salaire. </p>
|
||||
<p>Évolution des durées max d'indemnisations :
|
||||
|
|
|
|||
16
index.html
16
index.html
|
|
@ -84,10 +84,6 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Journal</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/prendre-le-temps.html">Prendre le temps</a>
|
||||
|
|
@ -112,6 +108,10 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/prix-libre-et-conscient.html">Prix libre et conscient & culpabilisation</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/ecran-et-dependances.html">Écran et dépendances</a>
|
||||
</li>
|
||||
<li><span class="metadata date">…</span><a class="post_title" href="/category/journal.html">plus d'articles </a> </li></ul>
|
||||
|
||||
<ul class="articles_list">
|
||||
|
|
@ -148,6 +148,10 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
|
||||
<ul class="articles_list">
|
||||
<li><span class="metadata date"><h2>Notes</h2></span></li>
|
||||
<li>
|
||||
<span class="metadata date">janvier 2020</span>
|
||||
<a class="post_title" href="/packager-pour-debian.html">Packager pour Debian</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">décembre 2019</span>
|
||||
<a class="post_title" href="/assurance-chomage.html">Assurance chômage</a>
|
||||
|
|
@ -172,10 +176,6 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<span class="metadata date">juin 2013</span>
|
||||
<a class="post_title" href="/notes-economie-libidinale-et-economie-politique.html">Notes: Économie libidinale et économie politique</a>
|
||||
</li>
|
||||
<li>
|
||||
<span class="metadata date">mars 2013</span>
|
||||
<a class="post_title" href="/le-revenu-de-base.html">Le revenu de base</a>
|
||||
</li>
|
||||
<li><span class="metadata date">…</span><a class="post_title" href="/category/notes.html">plus d'articles </a> </li></ul>
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
|
|
@ -78,9 +78,9 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
<h1 class="post-title">Packager pour Debian</h1>
|
||||
|
||||
<span class="post-date">
|
||||
14 janvier 2020, dans <a class="no-color" href="category/journal.html">Journal</a>
|
||||
14 janvier 2020, dans <a class="no-color" href="category/notes.html">Notes</a>
|
||||
</span>
|
||||
<img id="illustration" class="illustration-Journal" src="" />
|
||||
<img id="illustration" class="illustration-Notes" src="" />
|
||||
|
||||
<div class="post article">
|
||||
<div id="toc_container">
|
||||
|
|
@ -98,6 +98,7 @@ styles, `#sidebar-checkbox` for behavior. -->
|
|||
</div>
|
||||
|
||||
</div>
|
||||
<em>Voici quelques notes prises autour d'un sujet donné. Je ne suis souvent pas l'auteur des contenus, et les notes peuvent parfois faire un peu « fouillis ». Faites avec ;-)</em>
|
||||
<h1>🌟</h1>
|
||||
|
||||
<p>Aujourd'hui j'ai fais un peu de packaging pour la distribution Linux Debian, avec l'aide d'un ami. C'était assez agréable de pouvoir me faire aider dans cet objectif : j'avais déjà tenté l'expérience en solo par le passé, et m'étais cassé les dents sur le sujet.</p>
|
||||
|
|
|
|||
Loading…
Reference in a new issue