Removed custom headings, fixed link

This commit is contained in:
Lucien Cartier-Tilet 2020-09-02 12:52:17 +02:00
parent d0af4088c4
commit da83a4dd5f
Signed by: phundrak
GPG Key ID: BD7789E705CB8DCA

View File

@ -1,28 +1,17 @@
#+title: Phundraks Blog
+author: Lucien “Phundrak” Cartier-Tilet
#+author: Lucien “Phundrak” Cartier-Tilet
#+hugo_base_dir: ../
#+hugo_section: ./
#+hugo_categories: emacs linux conlanging orgmode
#+options: auto-id:t
* Conlanging :@conlang:
:PROPERTIES:
:CUSTOM_ID: Conlanging-686e085f
:END:
** TODO Writing my conlanging docs with Emacs :emacs:conlanging:
:PROPERTIES:
:CUSTOM_ID: Conlanging-Writing_my_conlanging_docs_with_Emacs-9da00fc5
:END:
* Emacs :@emacs:
:PROPERTIES:
:CUSTOM_ID: Emacs-39709bf5
:END:
** [EN] Automatic Meaningful Custom IDs for Org Headings :emacs:orgmode:
:PROPERTIES:
:EXPORT_FILE_NAME: better-custom-ids-orgmode
:EXPORT_DATE: 2020-06-06
:export_hugo_menu: :menu "main"
:CUSTOM_ID: Emacs-EN_Automatic_Meaningful_Custom_IDs_for_Org_Headings-e0823ff5
:END:
Spoiler alert, I will just modify a bit of code that already exists, go
directly to the bottom if you want the solution, or read the whole post if
@ -31,9 +20,6 @@
#+TOC: headlines 1 local
*** The issue
:PROPERTIES:
:CUSTOM_ID: Emacs-EN_Automatic_Meaningful_Custom_IDs_for_Org_Headings-The_issue-f5257919
:END:
About two to three years ago, as I was working on a project that was meant
to be published on the internet, I looked for a solution to get fixed anchor
links to my various headings when I performed HTML exports. As some of you
@ -117,9 +103,6 @@
one of my headings manually. So, what to do?
*** A first solution
:PROPERTIES:
:CUSTOM_ID: Emacs-EN_Automatic_Meaningful_Custom_IDs_for_Org_Headings-A_first_solution-991a2326
:END:
A first solution I found came from [[https://writequit.org/articles/emacs-org-mode-generate-ids.html][this blog post]], where Lee Hinman
described the very same issue they had and wrote some Elisp code to remedy
that (its a great read, go take a look). And it worked, and for some time I
@ -137,9 +120,6 @@
Except…
*** These headers are not meaningful
:PROPERTIES:
:CUSTOM_ID: Emacs-EN_Automatic_Meaningful_Custom_IDs_for_Org_Headings-These_headers_are_not_meaningful-114cccf1
:END:
Ok, alright, thats still a huge step forward, we dont have to type any
CUSTOM_ID property manually anymore, its done automatically for us. But,
when I send someone a link like
@ -157,7 +137,7 @@
underscores and headings separated by dashes, with a final unique identifier
taken from an Emacs-generated UUID. Now, the same link as above will look
like
~https://langue.phundrak.com/eittland/Aperçu_structurel-Inventaire_phonétique_et_orthographe-Voyelles_pures-84f05c2c~.
~https://langue.phundrak.com/eittland#Aperçu_structurel-Inventaire_phonétique_et_orthographe-Voyelles_pures-84f05c2c~.
It wont be more readable to you if you dont speak French, but you can
guess it is way better than what we had before. I even added a safety net by
replacing all forward slashes with dashes. The last ID is here to ensure the
@ -247,9 +227,6 @@
id)))))
#+END_SRC
#+RESULTS:
: eos/org-custom-id-get
The rest of the code is unchanged, here it is anyway:
#+BEGIN_SRC emacs-lisp
(defun eos/org-add-ids-to-headlines-in-file ()
@ -298,23 +275,15 @@
#+end_html
* Linux :@linux:
:PROPERTIES:
:CUSTOM_ID: Linux-b2218719
:END:
** [Fr] Tutoriel Git et Github :linux:git:tutorial:tutoriel:
:PROPERTIES:
:EXPORT_FILE_NAME: tutoriel-git-et-github
:EXPORT_DATE: 2020-06-05
:export_hugo_menu: :menu "main"
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-2c516a4f
:END:
#+TOC: headlines 1 local
*** Git ? Qu'est-ce donc ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Git ?_Qu'est-ce_donc ?-15ac251c
:END:
Git est un logiciel de version de fichiers permettant de garder une trace de
toutes les modifications apportées au fichiers suivis dans un répertoire (un
dépôt) et ses sous-répertoires sous couvert quils naient pas été ignorés
@ -331,13 +300,7 @@
Toujours là ? Tu auras été prévenu·e.
*** Ça a lair cool, comment ça sobtient ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ça_a_lair_cool,_comment_ça_sobtient ?-e0bdf23a
:END:
**** Et surtout, comment ça sinstalle ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ça_a_lair_cool,_comment_ça_sobtient ?-Et_surtout,_comment_ça_sinstalle ?-e6c91540
:END:
Très bonne question Kevin. Tout dabord, il faut tassurer que git soit
installé sur ton système et utilisable depuis le terminal. Sous GNU/Linux,
tu peux linstaller via ton gestionnaire de paquet, ce qui rendra la
@ -372,9 +335,7 @@
de même suivre le tutoriel.
**** Ok cest bon, et il y a une configuration à faire ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ça_a_lair_cool,_comment_ça_sobtient ?-Ok_cest_bon,_et_il_y_a_une_configuration_à_faire ?-0a65ff2b
:END:
Tu peux configurer Git si tu le souhaites, oui. En général, il est
recommandé de paramétrer au moins son nom et son e-mail. Tu peux les
paramétrer via la ligne de commande :
@ -401,9 +362,6 @@
ligne sur ~gitconfig~ ne manque pas.
*** Ok très bien, comment on lutilise maintenant ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-9c66c261
:END:
Du calme Jean-Kevin, ralentis un peu. Comme le dit ce vieux dicton
Chinois :
#+begin_quote
@ -415,9 +373,6 @@
citation nest pas extraordinaire. Bref.
**** Je commence comment ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Je_commence_comment ?-b289e367
:END:
Si tu souhaites créer un dépôt git, rien de plus simple : créé ton
répertoire dans lequel tu travailleras, et déplace-y-toi. Ensuite, tu
pourra initialiser ton dépôt via la commande ~git init~.
@ -449,9 +404,6 @@
Discord).
**** Et pour rajouter des fichiers ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Et_pour_rajouter_des_fichiers ?-2e2eb4bc
:END:
Maintenant tu peux commencer à travailler sur ton projet. Mais tout
dabord, on va voir ce quil se passe si jamais on créé un fichier dans le
dépôt. Créé un fichier ~main.c~ dans lequel tu vas entrer ce code :
@ -466,8 +418,6 @@
Bref, si tu exécutes à nouveau git status, tu obtients cette sortie :
#+BEGIN_SRC text
$ git status
On branch master
@ -519,9 +469,6 @@
tu sais comment enregistrer des état de ton dépôt via les commits.
**** Cool, mais jai accidentellement mis un fichier en staging
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Cool,_mais_jai_accidentellement_mis_un_fichier_en_staging-fabc6773
:END:
Si jamais tu as un staging que tu veux annuler, tu peux utiliser la
commande ~git reset HEAD nomdufichier~ (ou plusieurs noms de fichiers) pour
annuler le staging. Une fois le fichier qui nest plus dans ton staging, tu
@ -564,9 +511,6 @@
fonctionnalités en plus/.
**** En fait, jai juste oublié un truc dans mon commit précédent
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-En_fait,_jai_juste_oublié_un_truc_dans_mon_commit_précédent-4fcf76cc
:END:
Si jamais tu veux à la place ajouter la modification dun fichier au
dernier commit (mettons, tu as oublié dajouter également un fichier
texte), tu peux utiliser loption ~--amend~ lors du commit du fichier
@ -598,9 +542,6 @@
taper Ctrl-X. Dans tous les cas, tu aurais dû utiliser Emacs.
**** Euh, jai oublié ce que jai changé lors du dernier commit
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Euh,_jai_oublié_ce_que_jai_changé_lors_du_dernier_commit-426ea6bf
:END:
Pas de panique ! Tu peux entrer la commande ~git diff~ afin de voir ce que
tout ce que tu as modifié lors de ton dernier commit. Et si tu ne souhaite
voir les modifications que dun certain fichier, tu peux ajouter le nom de
@ -672,9 +613,6 @@
#+END_SRC
**** Il y a des fichiers dont je me fiche dans mon dépôt
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Il_y_a_des_fichiers_dont_je_me_fiche_dans_mon_dépôt-30a69d4b
:END:
Dans ce cas, il est grand temps de te présenter le fichier ~.gitignore~.
Comme son nom lindique, il permet au dépôt dignorer des fichiers selon ce
que tu lui indiqueras. Par exemple, si tu veux ignorer tous les fichiers
@ -705,9 +643,6 @@
ainsi que le fichier ~pubspec.lock~, sans globbing non plus.
**** On est plusieurs dessus en fait…
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-On_est_plusieurs_dessus_en_fait…-ba7d7ecb
:END:
Pas de panique ! Git a été créé pour ça, et il dispose dune fonctionnalité
de branchage permettant davoir plusieurs versions coexistantes dun même
fichier. Cela peut être très utile pour avoir soit plusieurs personnes
@ -739,9 +674,6 @@
#+END_SRC
**** Jai accidentellement modifié des fichiers sur la mauvaise branche, mais je nai pas encore fait de commits.
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Jai_accidentellement_modifié_des_fichiers_sur_la_mauvaise_branche,_mais_je_nai_pas_encore_fait_de_commits.-1fe34c47
:END:
Tout va bien alors ! Tu vas simplement exécuter cette commande :
#+BEGIN_SRC text
$ git stash
@ -771,9 +703,6 @@
branche.
**** Du coup, Mathilde a bien avancé sur son code, et moi aussi, chacun sur notre branche. On fait comment maintenant ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Ok_très_bien,_comment_on_lutilise_maintenant ?-Du_coup,_Mathilde_a_bien_avancé_sur_son_code,_et_moi_aussi,_chacun_sur_notre_branche._On_fait_comment_maintenant ?-dc747e9d
:END:
Au bout dun moment, tu vas sans doute vouloir fusionner deux branches, par
exemple tu as finis de développer une nouvelle fonctionnalité sur la
branche ~nouvelle-branche~ et tu souhaites lajouter à la version stable de
@ -803,9 +732,6 @@
commit avant de faire ton merge.
*** Jai entendu parler de Github…
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Jai_entendu_parler_de_Github…-a5d23116
:END:
Tu commences à me plaire Enzo ! Github est un site web sur lequel tu peux
héberger des projets libres ou open-source (si tu ne connais pas la
différence, voici un article pour taider à comprendre, et un autre pour la
@ -829,9 +755,6 @@
à toi de trouver les autres.
*** Jai téléchargé un projet en zip
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Jai_téléchargé_un_projet_en_zip-98d972dc
:END:
Ou bien, tu peux télécharger le projet directement via git. Eh oui ! git
permet de gérer les dépôts dits distants, cest à dire ceux qui sont
hébergés sur un serveur en ligne, comme par exemple sur Github. Pour cela,
@ -855,9 +778,6 @@
graphique !)
*** Et si je veux créer mon propre dépôt sur Github
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Et_si_je_veux_créer_mon_propre_dépôt_sur_Github-f5f36a7f
:END:
Dans ce cas là, cest simple Brigitte. Il faut que tu te créés un compte sur
Github, puis tu cliques sur le bouton ~+~ et ~New Repository~. Tu lui donnes
le nom que tu souhaites (en loccurrence je le nomme ~temporary-repo~ car je
@ -878,9 +798,6 @@
cloner sur ta machine comme je te lai montré avant.
*** Et du coup, comment je met tout ça en ligne ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Et_du_coup,_comment_je_met_tout_ça_en_ligne_?-fbfa443b
:END:
Bon ok, ce nest pas aussi simple que ça. Une fois que tu as lié ton dépôt
au dépôt distant, il faudra que tu mettes en ligne tes commits quand tu en
auras loccasion. Pour ce faire, tu nas quà taper ~git push~ ; et la
@ -920,9 +837,6 @@
même merde pour Gitlab, Gitea et Cie).
*** Quelquun a fait des modifications depuis mon dernier commit, je récupère ça comment?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Quelquun_a_fait_des_modifications_depuis_mon_dernier_commit,_je_récupère_ça_comment?-33e53344
:END:
Pour faire un exemple, je viens de créer un ~README.md~ sur Github
directement. Ce type de fichiers est assez standard afin de présenter plus
ou moins en détails le dépôt et le projet qui y est lié, et son contenu
@ -948,9 +862,6 @@
#+END_SRC
*** Je suis en train de travailler sur le même fichier que Ginette
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Je_suis_en_train_de_travailler_sur_le_même_fichier_que_Ginette-d3466e56
:END:
Là, cest un problème qui aurait pu être évité avec lusage des branches
dont je tavais parlé plus haut, mais visiblement, vous êtes sur la même
branche. Pas bien. Dans ce cas-là, met-toi daccord avec Ginette pour savoir
@ -961,9 +872,6 @@
dans un coin à part et va annuler tes modifications.
*** Github ne veut pas de mes pushs sur le dépôt de Gilberte, oskour !
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Github_ne_veut_pas_de_mes_pushs_sur_le_dépôt_de_Gilberte,_oskour_!-650037f5
:END:
Du calme Jean-Célestin. Cela veut tout simplement dire que tu nas tout
simplement pas les droits décriture sur son dépôt. Du coup, soit tu peux
lui demander directement à ce quelle te donne les droits décriture si elle
@ -971,9 +879,6 @@
Github depuis ton fork où tu auras fait tes modifications.
*** Fork ? Pull request ? Que font des fourchettes et des pulls dans ce tuto ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Fork_?_Pull_request_?_Que_font_des_fourchettes_et_des_pulls_dans_ce_tuto_?-d36658bb
:END:
Ouhlà Billy, il va falloir remettre les choses au clair. Là il sagit de
quelque chose de spécifique à Github quà Git (doù le fait quon en discute
dans ce chapitre que le précédent).
@ -999,9 +904,6 @@
toute la honte du monde quil a été refusé.
*** Jai remarqué un bug ou une erreur, mais je ne peux pas corriger ça moi-même
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Jai_remarqué_un_bug_ou_une_erreur,_mais_je_ne_peux_pas_corriger_ça_moi-même-226790d2
:END:
Eh bien dans ce cas-là, ouvre une /issue/ Bernadette ; /issue/ qui en
français veut dire /problème/. Il sagit dun système de Github te
permettant de signaler quelque chose aux propriétaires du dépôt, il peut
@ -1019,9 +921,6 @@
le reproduire.
*** Les raccourcis et paramètres de Git
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Les_raccourcis_et_paramètres_de_Git-d799b97f
:END:
Comme jen avais parlé plus haut, il est possible de configurer git de façon
un peu plus poussée que simplement déclarer notre nom et notre adresse
e-mail dans notre =~/.gitconfig=. Il est par exemple possible de déclarer
@ -1090,9 +989,6 @@
- ~sw~ :: Pour rapidement savoir ce quil y a sur le stash.
*** Et cest tout ?
:PROPERTIES:
:CUSTOM_ID: Linux-Fr_Tutoriel_Git_et_Github-Et_cest_tout ?-de7b07f1
:END:
Cest déjà pas mal ! Mais non, ce nest certainement pas tout. Cependant, ce
tutoriel na pour but de tapprendre que les bases de Git et de Github, pas
de tout tapprendre ! Si tu souhaites aller plus loin, connaître plus de