Suite du sujet Hébergement De TiddlyWikis:
Voici la traduction FR pour héberger un Tiddlywiki sur Github
Prérequis
La liste des prérequis est assez courte, et vous avez besoin de les réaliser une seule fois :
- Un compte Github
- Un compte Travis-ci
Première configuration
Voici les étapes nécessaire pour la première configuration. Une fois faite, il sera très rapide
d’ajouter un nouveau wiki.
Configuration de Github
- Nous devons créer un jeton
Personal access token
pour autoriser nos script à publier sur notre compte github. C’est nécessaire seulement la première fois. Aller à la page de gestion des jetons : Github’s tokens management page - Créer un nouveau jeton en cliquant sur
Generate new token
- Donner une description significative au jeton. C’est très important car elle sera la seule clé qui vous permettra d’identifier le jeton.
- Vérifier que les options
repo
etpublic_repo
sont sélectionnées. - Cliquer sur
Generate token
.
Voici à quoi ressemble cette étape.
Image - Github générera un jeton unique. Noter le bien tout de suite car vous n’aurez pas d’autre occasion de la faire.
Créer le premier wiki
- Forker le dépot. Cette étape sera nécessaire pour chaque wiki. Comme promis , vous pouvez faire cela directement depuis Github, Il suffit de cliquer sur le bouton en haut à droite de cette page.
- Une fois le dépôt copié, vous pouvez le renommer comme bon vous semble.
- Allez sur le site Travis-ci and connectez-vous en utilisant votre compte Github.
- Si c’est la première fois que vous utilisez Travis , autoriser simplement l’application à accéder à votre compte Github.
- Une fois connecté à votre compte Travis, vous serez dirigé vers votre tableau de bord.
- Sur la gauche de votre tableau de bord, vous devez avoir une liste des dépots gérés par Travis. Au début cette liste est vide.
- Cliquez sur le signe + (à coté de
My Repositories
) pour mettre votre dépôt forké dans le gestionnaire de Travis. - Vous serez redirigé sur votre profile. La , vous devez trouver la dépôt que vous avez forké, et l’activer en cliquant sur le bouton devant le nom (croix grise qui devient un coche verte). Ca devrait être facile , car Travis fournit une explication avec des copies d’écrans.
- Si vous ne trouvez pas les dépôts que vous cherchez, cliquez sur le bouton
Sync
pour rafraîchir la liste. - Dans notre exemple , nous activons ce dépôt :
https://github.com/danielo515/TW5-auto-publish2gh-pages/raw/screenshots/Travis-CI_activate.png?raw=true - Maintenant il est temps de configurer les variables globales utilisées par notre script. Pour cela, cliquez sur l’engrenage, à coté du bouton d’activation.
https://github.com/danielo515/TW5-auto-publish2gh-pages/raw/screenshots/Travis-CI_config.png?raw=true - Vous êtes dans la page des Paramètres du dépôt. Laissez les options générales par défaut.
- Dans la section des variables d’environnements, nous allons ajouter les variables nécessaires.
i. D’abord ajoutezGH_REF
, qui est l’url de votre dépôt forké, sans le préfix https:// et
avec une extension.git
. Pour cette variable , vous pouvez activer (on
) leDisplay value in build log
, ainsi vous pourrez vérifier que c’est correct pour chaque build. Cliquer surAdd
https://github.com/danielo515/TW5-auto-publish2gh-pages/raw/screenshots/Travis-CI_GH_REF.png?raw=true
ii. . Faites de même pour ajouter la variableGH_TOKEN
, mais cette fois , assurer vous que laDisplay value in build log
n’est pas activé (OFF
). Collez ici le jeton Github crée précédemement .
iii. Suivez la même procédure pour la variableGH-EMAIL
. C’est l’email que vous utilisez dans votre compte github. Après ces étapes vous devez avoir quelque chose comme ça.
https://github.com/danielo515/TW5-auto-publish2gh-pages/raw/screenshots/Travis-CI_Variables.png?raw=true
iv. Les modifications sont enregistrées automatiquement, donc à ce stade, nous avons terminé la configuration et nous pouvons revenir à l’ongletcurrent
. - Cliquez sur l’onglet
current
pour voir ce qui se passe dans la phase de construction. Le process de construction se déroule à chaque fois que vous poussez une modification dans votre dépôt, et pas avant. Les construction en cours ressemble à cela :
https://github.com/danielo515/TW5-auto-publish2gh-pages/raw/screenshots/Travis-CI_Building.png?raw=true - Maintenant vous êtes prêt.
Modifier n’importe quel fichier ou créer un nouveau fichier dans votre dépôt forké, et poussez les modifications pour déclencher une construction. Vous pouvez le faire directement dans Github. Pour plus de détails sur ce process , voire la sectionModifier les tiddlers
. - Quand la construction s’est terminé avec succès, vous pouvez visiter l’url :
<votre-nom-git>.github.io/<votre-nom-de-dépot>
, pour voir la résultat.
Créer un autre wiki.
Une fois la première configuration terminée, il est plus facile de configurer un
autre wiki. Voici le résumé des étapes :
- Forker ce dépôt
- Renommer le dépôt comme vous le souhaitez.
- Aller sur Travis-ci et connectez-vous avec votre compte github.
- Dans le tableau de bord, sur la gacuhe, Cliquez sur le signe
+
à coté deMy Repositories
pour mettre votre dépôt forké dans le gestionnaire de Travis. - Trouvez le dépôt que vous venez de forker et activez le en cliquant sur le bouton d’activation.
- Si vous ne trouvez pas votre dépôt, cliquez sur le bouton
Sync
pour rafraichir la liste des dépôt.
7 Configurer les variables globales. - Modifier/ Ajouter vos tiddlers et faite un push. Ceci peut être fait directement depuis github.
Modifier les tiddlers
Vous pouvez modifier ou ajouter de nouveaux tiddler , directement dans github, ce qui est assez pratique, ou vous pouvez utiliser une editeur Markdown. La syntaxe de tiddlywiki n’est pas exactement celle de Markdown, mais reste suffisamment proche. Les editeurs Markdown vous aide à compléter les listes et fournissent un aperçu.
Vous pouvez utiliser Prose, qui est l’outil utilisé par Danielo pour écrire ce guide.
Prose
- Aller sur le site http://prose.io/
- Vous devez lié Prose avec votre github, pour pouvoir modifier et enregistrer les fichier de vos dépots.
- Cliquez sur
authorize on Github
etAuthorize aplication
- Une fois que vous avez autorisé l’application, vous pouvez commencer à créer et modifier les tiddlers.
i. Sélectionnez le dépôt de votre wiki.
ii. Aller dans le dossierwiki> tiddlers
iii. Sélectionner le tiddler à modifier ou créer un nouveau fichier. Si vous créer un nouveau fichier, assurer vous qu’il a une extension en.tid
.
iv. Quand votre tiddler est modifié, cliquez surSave
. Vous pouvez ajoutez un commentaire pour le commit si besoin.
Dilinger
Pour éditer les fichiers Markdown, Dillinger est une meilleur alternative. L’inconvenient, c’est
qu’il ne reconnait que les fichiers avec l’extensions .md
:
- Allez sur http://dillinger.io/
- Vous pouvez le lier à Github pour modifier et enregistrer les fichiers dans votre dépôt.
- Pour pouvoir enregistrer une tiddler de github, vous devez d’abord l’importer. La première fois vous devez autoriser l’application.
i. Cliquez surIMPORT FROM
ii. Dans le menu sélectionnezGithub
iii. Autorisez l’application
iv. Cliquez à nouveau surIMPORT FROM
pour sélectionnez le dépôt à modifier puis sélectionnez la branche Master
v. Allez dans le dossierwiki> tiddlers
.
vi. Sélectionnez le tiddler à modifier. - Quand votre tiddler est prêt, cliquez sur
SAVE TO
et sélectionnez github.