---
# System prepended metadata

title: PKM
tags: [document de travail]

---

---
robots: noindex, nofollow
---
# PKM - Brainstorming
## 25/03/2024

:::info
Présent.e.s : 
 - Konrad Hinsen
 - Nicolas Roelandt
 - Nicolas Sauret
 - Sébastien RC
 - Raphaelle K.

Durée : ~1h
:::


### sur PKM - échanges sur les technos / veille / questions posées

- liste de liens "techno"
    - question éditoriale / design / webinaire du 27 mai avec Nicolas Rougier
https://inacheve-dimprimer.net/
https://inacheve-dimprimer.net/articles/2021-05-27-nicolas-rougier.html
    - dispositif utilisé actuellement sur le PKM
https://silverbullet.md/
    - webomatic / éditorialisation d'ouvrage à partir de plateformes md
https://webomatic.vercel.app/
https://gitlab.com/pgno/webomatic
    - hackmd import/export
https://github.com/hedgedoc/hedgedoc/issues/222
- liste de liens "sur le collectif"
    - initiative alsacienne de culture convivialiste (réseau Eveille & Eco-info)
http://katzele.netlib.re/
    - sur le détournement de gitlab - travail asynchrone & synchrone d'une traduction
https://intelligibilite-numerique.numerev.com/numeros/n-5-2024/2916-traduire-collectivement-l-ontologie-formelle-du-cidoc-crm-en-francais-sur-la-plateforme-gitlab-un-projet-sous-le-prisme-simondonien-d-un-humanisme-technologique

### sur la JE du GT notebook de l'automne à Condorcet (?)
- point budget, la demande côté CIST permet d'avoir 3000€ de plus qui viennent s'ajouter aux 500€ de l'IRIHS.
- proposition d'un hackathon PKM pendant la JE (sur 2 jours) 


- conférences invité-es sur les questions 
    - éditoriale
    - d'écosophie[^1]
    - de reproductibilité
    - de langage (WIP)
        - langage de programmation & linguistique / Larry Wall (PERL)
https://piped.video/watch?v=ju1IMxGSuNE
https://piped.video/watch?v=LR8fQiskYII
        - notes de lecture 
            - langages de programmation abstraits / concrets (B. Mélès) : https://hackmd.io/oY-VTywkSpmCKylHaf2l_Q, 
            - "langage des choses" / [WIP] webinaire : https://hackmd.io/yeXt7jzHTxy9K6WAABjdOQ
            - langage & philosophie de la technique (L. Duhem) : à venir
        - littéracie
        - LP...
    - ...

### un agenda de travail avril 2024
- **2 avril / 15h - 16h** (après le webinaire Journal of Digital History) : 
    - travail sur JE (programme) & 
    - suite webinaire (épisciences notamment)
    - quid de l'article de positionnement du GT ? 
        - répondre à l'AAC technocritiques - 21/04 https://hackmd.io/oJBl-EwwSnOYxp575dJ5ug ? 
        - ou à celui de la revue humanités numériques - 8/07 https://journals.openedition.org/revuehn/3900 ?
- **11 avril / 10h - 12h PKM**

[^1]: voir par exemple : https://www.persee.fr/doc/chime_0986-6035_1996_num_28_1_2073
## 19/02/2024

:::info
Présent.e.s : 
 - Konrad Hinsen
 - Nicolas Roelandt
 - Sébastien RC
 - Raphaelle K.

Excusé.e.s : 
Absent.e.s :
:::

### déploiement actuel
https://gt-notebook.gitpages.huma-num.fr/nix/wiki-pandoc-nix/#home

### PKM Futur, cahier des charges : 


### Outils à explorer

:::warning
Colonne à compléter avec les items du cahier des charges
:::


[bla2](/k9qJjRncSVCSHcjmey2NMg)

[super note](/FDxU3E_hSM27t5okdBDFXQ)

[[super note](/FDxU3E_hSM27t5okdBDFXQ)]


| Outils    | Collaboration   | Syntaxe    | ZK Friendly | API         | Citation | CLI          | Versionnement |
| --------- |:--------------- |:---------- | ----------- | ----------- | -------- | ------------ | ------------- |
| Hackmd    | Temp Reel       | md         | Semi[^h_zk] | Oui[^h_cli] | Non      | Oui[^h_cli]  | Oui (github)  |
| LogSeq    | Temp Reel[^l_c] | md et org  | oui         | Oui[l_cli]  | Oui      | Oui[^l_cli2] | Oui           |
| MediaWiki | Temp Reel ?     | md et wiki | non         | Oui[^l_cli3]| Oui      | ?            | ?             |
| Zetllr    | ?               | md         | oui         | non         | Oui      | ?            | externe (git/nextcloud)|

[^h_zk]: Oui / Autocomplétion des notes ; Non / pas de backlink ; Non / Pas de graphe 
[^h_cli]: Voir les informations : https://hackmd.io/c/tutorials/
[^l_c]: Prévu, mais pas encore là.
[^l_cli]: https://logseq.github.io/plugins/
[^l_cli2]: https://github.com/cldwalker/logseq-query
[^l_cli3]: https://www.mediawiki.org/wiki/API:Main_page/fr

Item :
- Pouvoir changer de cap, ne pas être "lockin"
- utiliser une syntaxe lisible par une grande variété d'outils. Markdown aisèment convertible en HTML
- Quels sont les formats supportés par le md/org (math, images, etc.)
- Collaboration CIDOC : traduction en markdown, directement sur gitlab, temps d'échanges sur la base de connaissance (élaboration et évolution de la base de connaissance)
    - pour discuter du contenu: réunion en synchrone, un seul édite le document
    - les commentaires des choix, modifications se font dans les issues.
    - rendez-vous très réguliers
    - organisation qui a mis du temps à émergé
    - des issues orientées contenu et des issues sur le fonctionnement de la plateforme
- Contribution à minima : gitlab (compatible avec les novices)

- quel format pour la contribution ?
    - contribution individuelle
    - prévoir des moments de travail en groupe
- MédiaWiki : 
    - accepte le markdown, syntaxe wiki
    - solide, pérenne
    - gère l'édition simultanée
    - https://www.mediawiki.org/wiki/API:Main_page
- Question du lockin et de la pérénité
- hackMD très consommateur en énergie 
    - Ce qui est structurant dans le GT c'est les webinaires, avec des notes prisent en temps réel qui invitent à des réflexions plus longues.
    - HackMD serait à la fois base de connaissance et notes de réunion
    - lien à Github uniquement : https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github
    - `[[]]` permet de créer des notes avec des identifiants uniques (Zettelkasten friendly )
        - penser à régler les droits d'accès (privée par défaut)
 - Reconstruction de graphe possible côté front-end
     - attention à porter sur les liens internes
     -   
- En multi-outil c'est important d'avoir un nom de fichier un tant soit peu explicite (element de titre, date et/ou timestamp)
    - prévoir un modèle de note ?
        - LogSeq a un système de template
        - Org-Mode aussi
        - Zettlr dispose de snippets

- Compatibilité entre les markdown : 
    - Logseq ajoute des extensions à lui dans le markdown
        - `collapsed:: true`
        - hiérachisation des titres
            - ex: [[GT Notebook/bibliographie/Simondon]] crée le fichier `GT Noteboob__bibliographie__Simondon.md`
        - conversion LogSeq => MD: https://github.com/kcarnold/logseq2pandoc/blob/main/logseq2md.py
    - Entete un peu différente etre logseq et zettlr
    - définir une structure compatible qui ne seraient pas parsées par les outils
        - les métadonnées sont inclues dans le fichier
            - date
            - titre
            - auteurs/autrices
            - statut : finalisé, en cours, à faire
            - catégories

- Il nous faut quelque chose qui clean/nettoie les ajouts des outils (ex collapsed::true)
    - script lua pandoc ?
    - git hook ?
    - 
- Entête minimaux, défini pour notre usage, pas forcément besoin d'être parsé

Plusieurs niveaux de compléxité
    - complexe: Intégration avec une routine pour ceux qui ont un outil (LogSew, Emacs)
    - intermédiaire : interface gitlab
    - simple : Ceux qui n'ont aucun a priori peuvent utiliser HackMD
      - HackMD parcouru régulièrement pour être intégré dans le git

Processus d'apprentissage à documenter
    - git
    - outils d'édition

Proto *dokuwiki* pour niveau intermédiaire
    - plugin https://www.dokuwiki.org/plugin:gitbacked
    - lien avec hackmd et l'api pour reventiler 
    - lien avec git 
    
- Garder l'existant ?
    - notes de webinaire
        - matériau conséquent
        - relire et structurer
    - entrées bibliographiques
        - note individuelle + commentaires

Tester MDWiki (rendu markdown avec npm/js):
- http://dynalon.github.io/mdwiki/
- liens bidirectionnels ?
- intégration avec git ?

La note bibliographique est un type de note
    - à partir de Zotero, extraire et créer des notes/noeuds en fonction de certains tags

Privilégier les tags aux catégories
    - à condition d'avoir un thésaurus (Karl Voit: https://karl-voit.at/=)
        - https://karl-voit.at/2019/09/25/categories-versus-tags/
        - https://karl-voit.at/2017/04/18/classification/
    
### PKM Existant : 

https://gitlab.huma-num.fr/gt-notebook/nix

Trois éléments pour la compilation par le CI de gitlab (fichiers .gitlab.yml)

#### Logiciels de compilation des notes (wiki-script)

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/wiki-script/
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-script/-/blob/master/flake.nix)) package la librairie python qui compile les notes. C'est un fork de la librairie https://github.com/lggruspe/slipbox => https://github.com/reyman/slipbox .

:::warning
Depuis les modifications que j'avais fait dans le fork pour ajouter les citations ont été rappatriées dans la version originale de lggruspe. 
:::

#### Pandoc

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/pandoc-2-14-02
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/pandoc-2-14-02/-/blob/main/flake.nix?ref_type=heads)) qui package la bonne version de pandoc pour utilisation par wiki-script

#### Script de compilation final (wiki-pandoc)

Le script qui fait la syntese des nix flakes : pandoc & wiki-script 

C'est le [.gitlab.yml](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/-/blob/main/.gitlab-ci.yml) qui lance la compile des notes, requete Zotero et publie la page.

:::info
Racine : https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/
:::

Le script nix ([flake.nix](https://gitlab.huma-num.fr/gt-notebook/nix/wiki-pandoc-nix/-/blob/main/flake.nix)) qui fait la synthese de wiki-pandoc et pandoc.

#### Synthèse 

*Ce qui est bien :* 


*Ce qui est pas bien :*
