Selaa lähdekoodia

Ajout nouvel article : Lancement de mon blog

master
Heuzef 1 vuosi sitten
vanhempi
commit
30026a840d
6 muutettua tiedostoa jossa 100 lisäystä ja 222 poistoa
  1. +100
    -0
      content/articles/2023/blog.md
  2. +0
    -9
      content/articles/2023/travaux.md
  3. BIN
      content/assets/bg_pelican.jpg
  4. BIN
      content/assets/pelican.png
  5. +0
    -107
      output/category/web/index.html
  6. +0
    -106
      output/notes/travaux/index.html

+ 100
- 0
content/articles/2023/blog.md Näytä tiedosto

@@ -0,0 +1,100 @@
Title: Lancement de mon blog
Cover: assets/bg_pelican.jpg
Category: Informatique
Tags: pelican, python, auto-hébergement, web, blog
Date: 2023-08-01 0:00
Status: published

Suite à une bouillante réflexion, j'ai finalement pris la décision brillante d'exploiter mon site pour y partager toutes mes expériences excentriques.
J'ai bon espoir que les plus audacieux d'entre vous seront ravis de découvrir toutes les informations et astuces que je partage ici à la sueur de mon front 😁

## Pourquoi et pour quoi ?

Transformer mon site, qui, jusqu'à présent, assurait la simple fonction de "point d'accueil de mon nom de domaine parce qu'il en faut bien un" en quelque de plus pertinent.

Écrire et partager mes expériences de vie, apportera, je l'espère, plusieurs avantages. Les passionnés comme moi ont tous secrètement cette envie de partage, mais c'est autre chose de se lancer.

Sur ce blog, pas de thème précis, j'aborderais tout sujet et thématique selon mon humeur délirante du moment, sous la seule condition que le contenu sera en mesure de créer une frénésie de passion sans précédent auprès d'une foule en délire qui ne manquera pas de s'abonner au [Flux RSS <i class="fa fa-home"></i>](https://heuzef.com/feeds/all.atom.xml).

## Salut Pelican

C'est donc naturellement que je vais commencer à vous parler du choix de l'outil que j'utilise pour me lancer dans cette aventure : [Pelican](https://getpelican.com)

![Pelican](../../assets/pelican.png)

Cet outil est absolument parfait pour les dingos exigeants comme moi, ce moteur Python ultra léger permet de générer un site statique à partir de vos fichiers Markdown ou reStructuredText.

Aucune base de données ni moteur web requis, il suffit de lancer la moulinette et Pelican va vous recracher fissa un site web statique complet (HTML, CSS, JS).

Cette note est la première que je fais suite à une installation et configuration de mon instance Pelican et c'est clairement très efficace, car l'outil n'en reste pas moins puissant et offre un large choix de fonction (Gestion de thème, extenssions, Flux RSS, publications multi-langue, etc ... ), et surtout tout est à plât et versionné sur mon [git](https://git.heuzef.com/heuzef/heuzef_com), et la personnalisation est possible sans contrainte.

C'est auto-hébergeable, libre et documenté, bref rien à redire, c'est le pied, fait tourner c'est de la bonne.

Merci à mon tout-puissant Sensei [Ephase](https://xieme-art.org) pour m'avoir inspiré et aidé à découvrir cet outil 😎

## Faire connaissance avec le piaf

Une fois votre serveur web prêt, il vous faudra installer quelques nécessités : Python avec virtualenv, pip et make.

Pour les modules pip, voici une liste de quelques dépendances que j'utilise : [<i class="fa fa-file"></i> requirements.txt](https://git.heuzef.com/heuzef/heuzef_com/src/branch/master/requirements.txt)

### Installation et configuration

Allons-y Alonso ! ✊

```bash
# Activation du virtualenv Python
virtualenv ~/virtualenvs/pelican
cd ~/virtualenvs/pelican
source bin/activate

# Installation de Pelican dans votre dossier d'hébergement web
cd /var/www/html/
pip3 install -r requirements.txt
```

Puis il suffit de se laisser guider pour la configuration :

```bash
pelican-quickstart
```

Vient alors le choix du thème (j'ai personnellement opté pour [Pelican-Alchemy ✨](https://github.com/nairobilug/pelican-alchemy) pour le moment) et des extensions.
Puis finalement, il faut passer du temps à personnaliser les fichiers de configuration **.py**, ajouter votre contenu dans le dossier **content** et faire pointer votre serveur web sur le dossier **output** qui contient votre site statique généré.

```bash
/
├── content
│ └── (pages)
├── output
├── tasks.py
├── Makefile
├── pelicanconf.py # Main settings file
└── publishconf.py # Settings to use when ready to publish
```

### Exemple d'utilisation

Pour exemple, voici à quoi ressemble le fichier Markdown de cet article :

```Makefile
Title: Lancement de mon blog
Cover: assets/bg_pelican.jpg
Category: Informatique
Tags: pelican, python, auto-hébergement, web, blog
Date: 2023-08-01 0:00
Status: published

Blah blah ... et ils trépignèrent à la lecture de cette note ... blah blah !
```
Un pti coup de moulinette :

```bash
make publish
```

Et vouualaaa ! 👌

Vous avez les bases, la [documentation](https://docs.getpelican.com) de Pelican vous permettra d'aller plus loin ensuite.

À bientôt pour de nouvelles aventures !

+ 0
- 9
content/articles/2023/travaux.md Näytä tiedosto

@@ -1,9 +0,0 @@
Title: Site en travaux
Status: published
Date: 2023-07-25 22:00
Category: Web
Tags: pelican
Slug: travaux
Summary: Un peu de patience

Je débute tranquillement avec le generateur de site PELICAN ! Repassez par ici bientôt ;)

BIN
content/assets/bg_pelican.jpg Näytä tiedosto

Before After
Leveys: 1576  |  Korkeus: 519  |  Koko: 27 KiB

BIN
content/assets/pelican.png Näytä tiedosto

Before After
Leveys: 335  |  Korkeus: 239  |  Koko: 77 KiB

+ 0
- 107
output/category/web/index.html Näytä tiedosto

@@ -1,107 +0,0 @@
<!doctype html>
<html lang="fr">

<head>
<!-- Required meta tags -->
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

<title>Heuzef</title>
<link rel="canonical" href="https://heuzef.com/category/web/index.html">

<link rel="apple-touch-icon" href="https://heuzef.com/apple-touch-icon.png" sizes="180x180">
<link rel="icon" type="image/png" href="https://heuzef.com/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="https://heuzef.com/favicon-16x16.png" sizes="16x16">
<link rel="manifest" href="https://heuzef.com/manifest.json">
<meta name="theme-color" content="#333333">

<link rel="stylesheet" href="https://heuzef.com/theme/css/bootstrap.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/fontawesome.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/pygments/manni.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/theme.css">

<link rel="alternate" type="application/atom+xml" title="Full Atom Feed"
href="https://heuzef.com/feeds/all.atom.xml">


</head>

<body>
<header class="header">
<div class="container">
<div class="row">
<div class="col-sm-4">
<a href="https://heuzef.com/">
<img class="img-fluid rounded" src=https://heuzef.com/assets/logo_heuzef_hd.png alt="Heuze Florent">
</a>
</div>
<div class="col-sm-8">
<h1 class="title"><a href="https://heuzef.com/">Heuze Florent</a></h1>
<p class="text-muted">
Les notes excentriques d'un bidouilleur.
</p>
<ul class="list-inline">
<li class="list-inline-item"><a href="http://heuzef.link/cv" target="_blank"><i class="fa fa-file"></i> mon cv</a></li>
<li class="list-inline-item text-muted">|</li>
<li class="list-inline-item"><a href="https://heuzef.com/contact.html">Contact</a></li>
<li class=" list-inline-item text-muted">|</li>
<li class="list-inline-item"><a class="fab fa-linkedin" href="https://www.linkedin.com/in/heuzef/" target="_blank"></a></li>
<li class="list-inline-item"><a class="fab fa-git" href="https://git.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-heartbeat" href="https://status.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-map" href="https://network.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-rss" href="https://heuzef.com/feeds/all.atom.xml" target="_blank"></a></li>
</ul>
</div>
</div> </div>
</header>

<div class="main">
<div class="container">
<h1> Web Articles
</h1>
<hr>
<article class="row teaser">
<header class="col-sm-4 text-muted">
<ul>
<li title="2023-07-25T22:00:00+02:00">
<i class="fas fa-clock"></i>
Tue 25 July 2023
</li>
<li>
<i class="fas fa-folder-open"></i>
<a href="https://heuzef.com/category/web/">Web</a>
</li>
</ul>
</header>
<div class="col-sm-8">
<h4 class="title">
<a href="https://heuzef.com/notes/travaux/">Site en&nbsp;travaux</a>
</h4>
<div class="content">
Un peu de patience
</div>
</div>
</article>
</div>
</div>

<footer class="footer">
<div class="container">
<div class="row">
<ul class="col-sm-6 list-inline">
<li class="list-inline-item"><a href="https://heuzef.com/index.html"><i class="fa fa-home"></i> Accueil</a></li>
<li class="list-inline-item"><a href="https://heuzef.com/categories.html"><i class="fa fa-cubes"></i> Catégories</a></li>
<li class="list-inline-item"><a href="https://heuzef.com/tags.html"><i class="fa fa-tags"></i> Tags</a></li>
</ul>
<p class="col-sm-6 text-sm-right text-muted">
Généré avec <a href="https://github.com/getpelican/pelican" target="_blank">Pelican</a>
/ <a href="https://github.com/nairobilug/pelican-alchemy" target="_blank">&#x2728;</a>
/ <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Licence Creative Commons" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a>
</p>
</div> </div>
</footer>

</body>

</html>

+ 0
- 106
output/notes/travaux/index.html Näytä tiedosto

@@ -1,106 +0,0 @@
<!doctype html>
<html lang="fr">

<head>
<!-- Required meta tags -->
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

<title>Heuzef</title>
<link rel="canonical" href="https://heuzef.com/notes/travaux/index.html">

<link rel="apple-touch-icon" href="https://heuzef.com/apple-touch-icon.png" sizes="180x180">
<link rel="icon" type="image/png" href="https://heuzef.com/favicon-32x32.png" sizes="32x32">
<link rel="icon" type="image/png" href="https://heuzef.com/favicon-16x16.png" sizes="16x16">
<link rel="manifest" href="https://heuzef.com/manifest.json">
<meta name="theme-color" content="#333333">

<link rel="stylesheet" href="https://heuzef.com/theme/css/bootstrap.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/fontawesome.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/pygments/manni.min.css">
<link rel="stylesheet" href="https://heuzef.com/theme/css/theme.css">

<link rel="alternate" type="application/atom+xml" title="Full Atom Feed"
href="https://heuzef.com/feeds/all.atom.xml">
<meta name="description" content="Un peu de patience">


</head>

<body>
<header class="header">
<div class="container">
<div class="row">
<div class="col-sm-4">
<a href="https://heuzef.com/">
<img class="img-fluid rounded" src=https://heuzef.com/assets/logo_heuzef_hd.png alt="Heuze Florent">
</a>
</div>
<div class="col-sm-8">
<h1 class="title"><a href="https://heuzef.com/">Heuze Florent</a></h1>
<p class="text-muted">
Les notes excentriques d'un bidouilleur.
</p>
<ul class="list-inline">
<li class="list-inline-item"><a href="http://heuzef.link/cv" target="_blank"><i class="fa fa-file"></i> mon cv</a></li>
<li class="list-inline-item text-muted">|</li>
<li class="list-inline-item"><a href="https://heuzef.com/contact.html">Contact</a></li>
<li class=" list-inline-item text-muted">|</li>
<li class="list-inline-item"><a class="fab fa-linkedin" href="https://www.linkedin.com/in/heuzef/" target="_blank"></a></li>
<li class="list-inline-item"><a class="fab fa-git" href="https://git.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-heartbeat" href="https://status.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-map" href="https://network.heuzef.com" target="_blank"></a></li>
<li class="list-inline-item"><a class="fas fa-rss" href="https://heuzef.com/feeds/all.atom.xml" target="_blank"></a></li>
</ul>
</div>
</div> </div>
</header>

<div class="main">
<div class="container">
<h1> Site en&nbsp;travaux
</h1>
<hr>
<article class="article">
<header>
<ul class="list-inline">
<li class="list-inline-item text-muted" title="2023-07-25T22:00:00+02:00">
<i class="fas fa-clock"></i>
Tue 25 July 2023
</li>
<li class="list-inline-item">
<i class="fas fa-folder-open"></i>
<a href="https://heuzef.com/category/web/">Web</a>
</li>
<li class="list-inline-item">
<i class="fas fa-tag"></i>
<a href="https://heuzef.com/tag/pelican/">#pelican</a> </li>
</ul>
</header>
<div class="content">
<p>Je débute tranquillement avec le generateur de site <span class="caps">PELICAN</span> ! Repassez par ici bientôt ;)</p>
</div>
</article>
</div>
</div>

<footer class="footer">
<div class="container">
<div class="row">
<ul class="col-sm-6 list-inline">
<li class="list-inline-item"><a href="https://heuzef.com/index.html"><i class="fa fa-home"></i> Accueil</a></li>
<li class="list-inline-item"><a href="https://heuzef.com/categories.html"><i class="fa fa-cubes"></i> Catégories</a></li>
<li class="list-inline-item"><a href="https://heuzef.com/tags.html"><i class="fa fa-tags"></i> Tags</a></li>
</ul>
<p class="col-sm-6 text-sm-right text-muted">
Généré avec <a href="https://github.com/getpelican/pelican" target="_blank">Pelican</a>
/ <a href="https://github.com/nairobilug/pelican-alchemy" target="_blank">&#x2728;</a>
/ <a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="Licence Creative Commons" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a>
</p>
</div> </div>
</footer>

</body>

</html>

Ladataan…
Peruuta
Tallenna