diff options
author | Quentin Dufour <quentin@deuxfleurs.fr> | 2023-02-21 17:42:07 +0100 |
---|---|---|
committer | Quentin Dufour <quentin@deuxfleurs.fr> | 2023-02-21 17:42:07 +0100 |
commit | fce64d5c4cb9b1ca7e1d403fe221e24afbae03a8 (patch) | |
tree | 57d230d2a214490f7dce8e3b660ea3f94626687b | |
parent | 993845aa4fa5a21c9c978c0a57ec572c5300e554 (diff) | |
download | guide.deuxfleurs.fr-fce64d5c4cb9b1ca7e1d403fe221e24afbae03a8.tar.gz guide.deuxfleurs.fr-fce64d5c4cb9b1ca7e1d403fe221e24afbae03a8.zip |
remove temp files
-rw-r--r-- | content/prise_en_main/web/publier-le-contenu/_index.md~ | 16 | ||||
-rw-r--r-- | content/prise_en_main/web/publier-le-contenu/aws-cli.md~ | 71 | ||||
-rw-r--r-- | content/prise_en_main/web/publier-le-contenu/rclone.md~ | 104 | ||||
-rw-r--r-- | content/prise_en_main/web/publier-le-contenu/winscp.md~ | 62 | ||||
-rw-r--r-- | static/admin/config.yml | 4 |
5 files changed, 4 insertions, 253 deletions
diff --git a/content/prise_en_main/web/publier-le-contenu/_index.md~ b/content/prise_en_main/web/publier-le-contenu/_index.md~ deleted file mode 100644 index 442cd27..0000000 --- a/content/prise_en_main/web/publier-le-contenu/_index.md~ +++ /dev/null @@ -1,16 +0,0 @@ -+++ -title = "Publier le contenu" -description = "Comment mettre en ligne son contenu" -date = 2022-09-01 -weight = 0 -sort_by = "weight" -[extra] -weight_custom = 5 -+++ - -Nous allons désormais verser votre site sur Garage, et ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)». - -Vous avez le choix entre trois méthodes : -* [Faire ça en ligne de commande avec `aws-cli`](../aws-cli/). C'est la méthode la plus habituelle et la plus éprouvée, cependant il faut utiliser le terminal, et être sur linux est grandement conseillé pour celle-ci. -* [Faire ça avec l'utilitaire graphique `rclone`](../rclone/). Cette méthode vous paraîtra peut-être moins intimidante grâce à l'interface graphique du logiciel rclone. Celui-ci tourne sur Linux, Windows, et MacOS. -* [Faire ça avec l'utilitaire graphique `winscp`](../winscp/). Cette méthode propose elle également une interface graphique, mais ne fonctionne que sur Windows. diff --git a/content/prise_en_main/web/publier-le-contenu/aws-cli.md~ b/content/prise_en_main/web/publier-le-contenu/aws-cli.md~ deleted file mode 100644 index ba74e8c..0000000 --- a/content/prise_en_main/web/publier-le-contenu/aws-cli.md~ +++ /dev/null @@ -1,71 +0,0 @@ -+++ -title = "aws-cli" -description = "Publier avec aws-cli" -date = 2022-09-01 -weight = 1 -+++ - -Nous allons désormais verser votre site sur Garage, ce dernier le servira à toutes les personnes qui voudront le voir. Vous aurez besoin de l'identifiant de votre clé d'accès et de la clé d'accès secrète, obtenus dans la partie «[Initialiser votre accès](../initialiser-votre-acces/)». - -### Paramétrer votre accès localement -Pour verser votre site sur Garage, nous allons utiliser l'outil de base pour faire des commandes S3 : [aws-cli](https://github.com/aws/aws-cli) et son binaire, `aws`. À chaque fois, il aura besoin de savoir : -* l'identifiant de votre clé d'accès -* votre clé d'accès secrète -* la région et l'URL de l'infrastructure Garage qui hébergera votre site - -En temps normal, il faudrait préciser ces paramètres à chaque fois (donc toutes les fois que vous voulez mettre quelque chose sur votre site, ou le modifier). Pour éviter ça, on va stocker ces informations dans un fichier ; il suffira de l'invoquer avant de faire ses modifications. Dans votre répertoire personnel, créez un fichier nommé par exemple `.awsrc`. À l'intérieur, mettez le contenu suivant : -``` -export AWS_ACCESS_KEY_ID={votre identifiant de clé d'accès} -export AWS_SECRET_ACCESS_KEY={votre clé d'accès privée} -export AWS_DEFAULT_REGION='garage' - -function aws { command aws --endpoint-url https://garage.deuxfleurs.fr $@ ; } -aws --version -``` -Il vous faut bien entendu insérer vos deux clés aux endroits spécifiés. Une fois ceci fait, dans le futur, avant d'utiliser `aws`, il vous faudra faire `source ~/.awsrc`, et cela mettra en place tous les paramètres pour vous. Vous serez automatiquement authentifié et vous parlerez à la bonne infrastructure Garage. - -### Configurer la page par défaut et celle pour les erreurs -Puisqu'on est sur la configuration S3, profitons-en pour paramétrer une page d'accueil et une page d'erreur. En effet, les URL qu'on utilise pour naviguer sur votre site correspondront à la hiérarchie de fichiers présents sur Garage. Si on visite `https://votre-site.fr/blog/recette-de-gateau.html`, Garage va simplement servir le fichier `blog/recette-de-gateau.html`, en partant de la racine du bucket. Mais que ce passe-t-il si on demande à voir `https://votre-site.fr/blog/` ? Garage ne peut pas retourner un dossier; et de toute façon cela ne fonctionnerait pas, puisqu'un dossier n'a pas données propre à lui-même, il ne fait que contenir des fichiers distincts en son sein. On voit pourtant souvent ce genre d'URL en ligne. En fait, les serveurs web sont configurés pour que si aucun fichier du dossier n'est spécifié, alors on va utiliser celui avec un nom paramétré à l'avance. C'est de ça dont on parle. -De même, lorsque quelqu'un demande une page qui n'existe pas, que peut faire Garage ? Dans la même logique, on va lui donner un nom de fichier à servir par défaut si jamais cela arrive. - -Après avoir fait votre `source ~/.awsrc`, faites : -``` -aws s3 website exemple-un.fr --index-document index.html --error-document erreur.html -``` -si votre `aws` est en version 2.x, ou -``` -aws s3api put-bucket-website --bucket exemple-un.fr --website-configuration ' -{ - "ErrorDocument": { - "Key": "/errors/4xx.html" - }, - "IndexDocument": { - "Suffix": "index.html" - } -} -' -``` -s'il est en version 1.x . Pensez à remplacer `exemple-un.fr` par votre nom de domaine à vous ! - -### Publier -On y est ! Avec un terminal, positionnez-vous dans le répertoire qui reflète ce que vous voulez mettre en ligne. Celui-ci devrait contenir des fichiers en `.html`, `.css`, ou `.js`, mais pas de `.md`. Si vous ne l'avez pas fait, faites `source ~/.awsrc`, et lancez ensuite : -``` -aws s3 sync . s3://exemple-un.fr -``` -si vous avez `aws` en version 2. N'oubliez pas de mettre votre nom de domaine à la place d'`exemple-un.fr`. Vos fichiers devrait être téléversés. Une fois le processus fini, vous devriez pouvoir ouvrir un navigateur internet tel que Firefox par exemple, tapez votre nom de domaine dans la barre URL, et naviguer sur votre site. En cas de pépin, essayez d'actualiser la page en faisant `ctrl`+`shift`+`r` avec votre clavier, ça vous garantira que votre navigateur récupère le vrai contenu en ligne au lieu de piocher dans le cache local sur votre ordinateur. - -### Bravo ! -Fécilicitations ! Vous avez désormais votre propre site web accessible publiquement en ligne ! -Vous pouvez rajouter dessus le badge attestant fièrement son hébergement sur Garage: - -[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) -[![Badge indiquant qu'un site est hébergé sur Garage en anglais](/img/garage_en.png)](https://garagehq.deuxfleurs.fr/) - -En HTML: -``` -<a href="https://garagehq.deuxfleurs.fr/"><img src="garage_fr.png" alt="Badge indiquant que ce site est propulsé par le logiciel Garage" title="Site propulsé par Garage"></a> -``` -En Markdown: -``` -[![Badge indiquant qu'un site est hébergé sur Garage en français](/img/garage_fr.png)](https://garagehq.deuxfleurs.fr/) -``` diff --git a/content/prise_en_main/web/publier-le-contenu/rclone.md~ b/content/prise_en_main/web/publier-le-contenu/rclone.md~ deleted file mode 100644 index d7e03d1..0000000 --- a/content/prise_en_main/web/publier-le-contenu/rclone.md~ +++ /dev/null @@ -1,104 +0,0 @@ -+++ -title = "Rclone Browser" -description = "Rclone Browser" -weight = 30 -date = 2021-11-25T14:31:35.570Z -dateCreated = 2021-11-25T14:02:30.997Z -[extra] -weight_custom = 15 -+++ - - -rclone browser est un outil simple qui vous permet d'accéder directement à Garage. - -# Installation - -Si vous êtes sous macOS ou Windows, vous pouvez télécharger la dernière version depuis la page [github de rclone-browser](https://github.com/kapitainsky/RcloneBrowser/releases) (descendez un peu pour voir les liens). - -Sous Ubuntu (lubuntu, kubuntu, etc.), Debian et Linux Mint, cherchez et installez "Rclone Browser" dans la logithèque ("App Store") ou lancez directement depuis un terminal : - -```bash -sudo apt-get install -y rclone-browser -``` - ---- - -Le paquet existe aussi pour d'autres distributions : - -```bash -sudo dnf install -y rclone-browser # fedora -sudo yay -S rclone-browser # arch linux -sudo nix-env -iA nixos.rclone-browser # nix os -``` - -# Premier lancement - -Avant de lancer Rclone Browser, ouvrez un éditeur de texte. -Moi j'utilise "Éditeur de texte" sous Gnome aussi connu sous le nom de `gedit`. Sous Windows il s'appelle Bloc-Note Windows (ou `notepad.exe`). - -![gedit.png](/img/rclone_gedit.png) - -Entrez le texte suivant dedans, tout en remplaçant bien les lignes 5 et 6 par vos identifiants communiqués précédemment : - -```toml -[garage] -type = s3 -provider = Other -env_auth = false -access_key_id = <REMPLACEZ PAR VOTRE IDENTIFIANT DE CLE D'ACCESS> -secret_access_key = <REMPLACEZ PAR VOTRE CLE D'ACCES SECRETE> -region = garage -endpoint = garage.deuxfleurs.fr -bucket_acl = private -force_path_style = true -no_check_bucket = true -``` - -Maintenant enregistrez le à un endroit où vous ne le perdrez pas. Dans mon cas, j'ai choisi de le mettre dans Mon Dossier Personnel > Documents > Configuration et je l'ai appelé `rclone.conf`. - -![rclone-conf.png](/img/rclone_conf.png) - -Maintenant lancez "Rclone Browser" en cherchant l'application dans votre menu d'application - -![capture_d’écran_de_2021-11-25_14-43-03.png](/img/rclone_menu.png) - -L'application devrait se lancer : - -![rclone_init.png](/img/rclone_init.png) - -Cliquez sur "File" (Fichiers) en haut à gauche, puis sur "Preferences...". La fenêtre suivante s'ouvre : - -![rclone-conf2.png](/img/rclone_conf2.png) - -Repérez la deuxième ligne intitulée `rclone.conf location:`. Tout au bout de la ligne, cliquez sur le bouton avec les trois points `[...]`. Vous aurez alors la possibilité d'indiquer à Rclone Browser où se trouve le fichier de configuration créé juste avant (pour ma part, je rappelle, "Dossier personnel > Documents > Configuration > rclone.conf", on voit que le chemin complet vers le fichier apparait maintenant dans le champs texte. - -Appuyez sur OK, et la fenêtre principale devrait maintenant ressembler à ça : - -![rclone-s3.png](/img/rclone_s3.png) - -Cliquez sur "S3 garage" puis cliquez sur "Open". Si vous voyez des dossiers apparaitre, c'est gagné ! - -![rclone-conn.png](/img/rclone_conn.png) - -Vous pouvez maintenant naviguer dans vos dossiers, envoyer des fichiers sur Garage ou en récupérer. Attention, vous ne pouvez pas créer de "nouveaux dossiers" à la racine, mais vous pouvez créer des sous-dossiers dans les dossiers existants pré-alablement créés pour vous. - -# Utiliser comme un drive - -Ce n'est pas forcément très pratique de devoir passer par cette interface pour envoyer ou récupérer des fichiers. Ce qui serait génial, c'est que ces dossiers apparaissent sur votre ordinateur comme des dossiers normaux. - -Pour cela, sélectionnez un dossier racine, moi j'ai choisi `quentin.bibliotheque` puis cliquez sur le bouton "Mount". - -![rclone-mount.png](/img/rclone_mount.png) - -Un sélecteur de fichier s'ouvre alors. Je vais dans "Dossier Personnel > Documents", je créer un nouveau dossier que j'appelle "Distant". Je vais dedans et clique sur "Choisir" (ou Ok). - -Maintenant, quand je vais dans un explorateur de fichier, je vois les fichiers sur Garage comme si ils étaient sur mon ordinateur. - -![nautilus-distant.png](/img/rclone_nautilus.png) - -Je peux aussi accéder à ces documents depuis mon logiciel préféré, comme ici "LibreOffice Calc" : - -![capture_d’écran_de_2021-11-25_15-01-42.png](/img/rclone_calc.png) - - - diff --git a/content/prise_en_main/web/publier-le-contenu/winscp.md~ b/content/prise_en_main/web/publier-le-contenu/winscp.md~ deleted file mode 100644 index 6f63d97..0000000 --- a/content/prise_en_main/web/publier-le-contenu/winscp.md~ +++ /dev/null @@ -1,62 +0,0 @@ -+++ -title = "WinSCP" -description = "WinSCP " -weight = 20 -[extra] -weight_custom = 10 -+++ - - -# Installation - -Commencez par télécharger l'outil [WinSCP](https://winscp.net/eng/download.php). - -![winscp_dl.png](/img/winscp_dl.png) - -Installez le logiciel. - -# Configuration - -Lancez le. La fenêtre de connexion suivante devrait apparaitre : - -![](/img/winscp_login.png) - -Vous devez : - 1. Vérifier que c'est bien "Nouveau site" qui est sélectionné - 2. Dans *protocole de fichier*, vous devez choisir *Amazon S3* - 3. Dans *nom d'hôte*, vous devez mettre `garage.deuxfleurs.fr` - 4. Dans *numéro de port*, vous devez mettre (ou plutôt laisser) `443` - 5. Dans *id de clé d'accès*, vous devez mettre l'identifiant de votre clé d'accès, exemple : `GK...` - 6. Dans *clé d'accès secrète*, vous devez mettre votre clé d'accès secrète. - 7. Maintenant, cliquez sur le bouton *Avancé*. (Cliquez bien sur le mot "Avancé" et non sur la flèche à droite). Une fenêtre s'ouvre : - -![](/img/winscp_avance.png) - - 1. Dans le menu de gauche, cliquez sur *S3* - 2. Dans la partie de droite, pour *Région par défaut*, inscrivez au clavier *garage* - 3. Toujours à droite, dans *Style URL*, choisissez *Chemin* - 4. Cliquez sur OK - -Vous voilà de retour sur la fenêtre de connexion : - -![](/img/winscp_sauvegarder.png) - - 1. Cliquez sur *Sauver* (cliquez bien sur le texte et non sur la flèche noire à droite) - -La fenêtre suivante apparait : - -![](/img/winscp_session.png) - - 1. Dans *Enregistrer la sessions sous :*, donnez un nom qui identifie bien votre site web, c'est ce qui vous permettra de l'identifier dans la liste de connexion. - 2. Pour la case *Enregistrer le mot de passe*, nous vous conseillons de la cocher sauf si vous êtes sur un ordinateur public (bibliothèque, cybercafé, etc.) ou au travail. - 3. Pour la case *Créer un raccourci sur le bureau*, nous vous conseillons de la cocher, vous pourrez alors mettre votre site en ligne en un seul clic (ou presque) depuis votre bureau. - 4. Cliquez sur OK - -Vous pouvez maintenant cliquer sur "Connexion". - -# Envoyer votre site web - -À gauche, naviguez jusqu'au dossier de votre site web. -Faites en un glisser déposer à droite à l'intérieur du dossier qui contient le nom de votre site web. - -![commander.png](/img/winscp_commander.png) diff --git a/static/admin/config.yml b/static/admin/config.yml index a7e74bd..77d46e6 100644 --- a/static/admin/config.yml +++ b/static/admin/config.yml @@ -17,6 +17,9 @@ collections: editor: preview: false create: true + nested: + depth: 3 + summary: '{{title}}' fields: - label: Title name: title @@ -28,3 +31,4 @@ collections: name: body widget: markdown modes: [ 'raw', 'rich_text' ] + meta: { path: { widget: string, label: 'Path', index_file: 'index' } } |