Fichier de tests du plugin CSV

%SEE_SOURCE%

Ce plugin de type content markdown va permettre d’insérer dans une note un fichier .csv externe.

Gérer un tableau en markdown n’est pas si compliqué (au lieu de mettre un “;” comme séparateur, il faut utiliser le signe pipe “ | ”) mais, dès lors qu’il convient de manipuler le tableau (insérer une colonne, ajouter une ligne, ...) devient un peu plus ennuyeux puisque, p.ex., il ne faut pas oublier de mettre autant de “ | ” qu’il y a de colonnes. Si on en oublie un, la mise en page du tableau est cassée.

Permettre de manipuler le fichier tableau depuis un logiciel externe comme un tableur; ouvrir, éditer et sauver le tableau ainsi, est bien plus simple.

Et, grâce au plugin CSV, la note est immédiatement mise à jour par la simple mise à jour du fichier .csv. Il suffit donc d’en déposer une nouvelle version pour que la note l’affiche.

Exemples

Liste des villes et codes postaux de Belgique (récupéré sur le site http://www.vinch.be/blog/2010/03/16/villes-de-belgique-aux-formats-csv-xml-json-et-sql/)

%CSV csv_sample.csv%

Le fichier utilisé est celui-ci : csv_sample.csv

Paramètrage du fichier d’exemple :

Si le fichier avait utilisé une virgule et non un point virgule comme séparateur, il faudrait modifier la valeur du paramètre separator du fichier settings.json.

{
    "csv": {
        "separator": ";",
        "value_separator" : "",
        "md_column_separator": "| "
    }
}

Utilisation

% CSV csv_sample.csv%

(sans l’espace devant le mot CSV)

Paramétrage

Ci-dessous un exemple de paramétrage du plugin CSV.

{
    "plugins": {
        "options": {
            "page": {
                "html": {
                    "csv" : {
                        "separator" : ";"
                    }
                }
            }
        }
    }
}