org-report-stats/README.md

org-report-stats

Compte rendu html des tâches réalisées dans des fichiers Orgmode.

Ce dépot permet plusieurs choses:

• convertir des fichiers orgmode en json
• faire fonctionner un serveur web express / node pour afficher un compte rendu HTML interprêtant un fichier json représentant des tâches orgmode exportées à partir d'ox-json dans emacs. pour le lancer: npm start.
• convertir des exports de services numériques en fichier tsv et json, afin d'être utilisé par les autres parties pour en faire un compte rendu en html.
• un convertisseur de site wordpress vers orgmode. La source est un export au format json de la table des posts d'un site wordpress, réalisé dans un client de base de données comme phpmyadmin ou un IDE tel que PhpStorm.

Prérequis

• une connaissance d'Orgmode pour exporter les tâches archivées
• un export json de vos tâches archivées (voir ox-json)
• mettre l'export json dans le dossier source
• avoir Nodejs en version stable et installer les modules node.

Utilisation

Configuration

Vérifiez les variables de chemin dans parse_orgmode_to_json.mjs, surtout outputAbsolutePath pour avoir un lieu de génération de fichier.

compiler les fichiers org et les convertir en json

Il suffit de lancer cette commande du Makefile

 make convert

Elle réalise la concaténation des fichiers tasks.org et tasks.org_archive faite dans all_tasks.org qui est ensuite utilisé par le script parse_orgmode_to_json.mjs pour fabriquer un fichier json.

la sortie est générée dans "outputAbsolutePath" définie dans "parse_orgmode_to_json.mjs"

rendu graphique

ts-node render_chart.ts sort un graphique des tâches crées et complétées selon les différents agrégats de temps. à configurer dans le fichier render_chart.ts.

Données générées

Des statistiques

• Les nombres et le type de tâches agrégées par semaine, mois et années.

• le nombre de tâches avec une date.

• le nombre de tâches sans date.

• la date de la tâche la plus ancienne

• données agrégées

• Les nombres de fois que des tags sont utilisés dans les tâches.

• Les nombres de fois que des mots sont utilisés dans les tâches.

• des données sur l'auteur, la date de génération du json, le fichier source .org ayant servi à la conversion.

voir le rendu

Lancer l'exécution du fichier app avec node, et consulter l'output html.

 npm start

Memacs

Les scripts inspirés de Memacs (le package python-pip) sont dans le dossier converters, ils permettent de convertir des fichiers exportés de divers outils numériques en feuilles de calcul pour avoir un historique général d'activités simple à lire pour les humains, et facile à analyser pour d'autres scripts.

feuille de route TODO

• Proposer une sortie json qui soit du même format que l'export ox-json d'emacs.
• Inclure les sous tâches aux catégories

DONE