Skip to content

Commit

Permalink
Move missing files
Browse files Browse the repository at this point in the history
  • Loading branch information
luccasmmg committed Oct 6, 2023
1 parent 9482483 commit 8f4c134
Show file tree
Hide file tree
Showing 49 changed files with 1,192 additions and 60 deletions.
8 changes: 8 additions & 0 deletions examples/openspending/components/Header.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,10 @@ export function Header() {
title: 'Contributing',
href: '/contributing',
},
{
title: 'Help',
href: '/help',
},
{
title: 'Resources',
href: '/resources',
Expand All @@ -73,6 +77,10 @@ export function Header() {
title: 'Working Group On Open Spending Data',
href: '/resources/wg/',
},
{
title: 'UK Departamental Spending',
href: '/resources/gb-spending',
},
],
},
];
Expand Down
25 changes: 25 additions & 0 deletions examples/openspending/content/help/guide/en/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
section: help
lead: true
title: The OpenSpending Guide
authors:
- Neil Ashton
---
The OpenSpending Guide is the manual for OpenSpending, covering the entire process of finding, adding, and using data with OpenSpending in detail.

* Introduction
* [What is OpenSpending?](en/what-is-openspending)
* [What types of financial data can go into OpenSpending?](en/financial-data-types)
* [How does OpenSpending represent data?](en/data-model)
* Adding Data to OpenSpending
* [Overview](en/adding-data-overview)
* [Gathering data](en/gathering-data)
* [Formatting data](en/formatting-data)
* [Publishing data on the web](en/publishing-data)
* [Creating a dataset on OpenSpending](en/creating-dataset)
* [Modelling your data in OpenSpending](en/modelling-data)
* Visualizations
* [Create a visualization](en/create-viz)
* [Embed a visualization on your website](en/embed-viz)

**Up**: [OpenSpending guides](/help)
10 changes: 10 additions & 0 deletions examples/openspending/content/help/guide/esp/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
section: help
lead: true
title: Guía de OpenSpending (Gasto Abierto)
authors:
- Anders Pedersen
---
<a href="https://docs.google.com/a/okfn.org/document/d/1sl9Fvtbp5y-XDnY6cosZb5CJQw-oAD_zs1kVqBovk14/edit#heading=h.79vyyu8n203g">Guía de OpenSpending (Gasto Abierto)</a> (as a Google Doc).

The guide needs to be reformatted and posted here (in markdown). You can help by getting in touch with <a href="http://community.openspending.org/contribute/">the community here</a>.
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
section: help
lead: true
title: Ajouter des données dans OpenSpending
authors:
- lombardoelisabetta
---
L’une des contributions les plus utiles que vous pouvez faire sur OpenSpending est d’ajouter un nouveau jeu de données. Ce paragraphe vous explique en détails comment faire.

Une démarche classique pour importer un jeu de données sur OpenSpending suit les étapes suivantes:

* Rassembler les données lisibles par une machine depuis une source officielle.
* Convertir les données dans le format CSV supporté par OpenSpending. Nettoyer le jeu de données pour supprimer les erreurs et les éventuelles incohérences.
* Publier le jeu de données sur le web.
* Créer un jeu de données sur OpenSpending en indiquant la source (URL) du jeu de données.
* Créer un modèle en définissant le rôle de chaque colonne du jeu de données.
* Charger les données, ou corriger le jeu de données en vous aidant des recommandations fournies par OpenSpending sur la cohérence des données.

Chacune de ces étapes est détaillée dans les sections suivantes.

&nbsp;

**Suivant**:[<a href="../rassembler-les-donnees/">Rassembler les données</a>]

&nbsp;

**Précédent**: [<a href="../representation-des-donnees-dans-openspending/">Représentation des données dans OpenSpending</a>]
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
section: help
lead: true
title: Créer un jeu de données sur OpenSpending
authors:
- lombardoelisabetta
---
Pour pouvoir partager vos données sur OpenSpending, vous devez d’abord vous enregistrer sur le site OpenSpending.org. Pour créer un jeu de données, il vous suffira ensuite d’indiquer ses métadonnées et son URL.

###Créer un nouveau jeu de données

Connectez-vous sur OpenSpending avec vos informations d’utilisateur. Vous serez ensuite redirigé vers le Dashboard. Cliquez sur le bouton **Import a Dataset** pour créer un nouveau jeu de données.

L’écran suivant vous invite à fournir les métadonnées qui définissent votre jeu de données. Voici les informations demandées :

* _Title_ (Titre): une description et un nom explicite pour le jeu de données.
* _Identifier_ (Identifiant): un titre court, utilisé dans l’URL du jeu de données. L’identifiant peut contenir uniquement des caractères alphanumériques, des tirets, et des traits bas – ni espace blanc ni signe de ponctuation.
* _Category_ (Catégorie): pouvant être “Budget” (Budget), “Expenditure” (Dépense) ou “Other” (Autres). Référez-vous aux types de données financières pour des détails sur ces catégories.
* _Currency_ (devise): la devise utilisée pour les montants dans le jeu de données.
* _Countries_ (Pays): une liste de pays référencés dans le jeu de données. Le choix des pays est contraint à une liste de pays valides.
* _Languages_ (Langue): une liste des langues utilisées dans le jeu de données. Le choix des langues est contraint par une liste de langues valides.
* _Description_ (Description): une définition du jeu de données en langage simple.

Remplissez ces champs. Assurez-vous d’inclure une description qui explique l’origine de votre jeu de données et les modifications apportées (par exemple que le jeu de données a été nettoyé).

Dès que toutes les métadonnées ont été renseignées, cliquez sur **Next Step** pour continuer.

###Ajouter une nouvelle source de données

L’étape suivante vous emmène sur la page _Manage_ (Gestion). La page _Manage_ est utilisée pour ajouter la source du jeu de données. Elle est aussi utilisée pour créer le modèle de schéma de données qui permet à OpenSpending d’interpréter les informations. Cette étape, dénomée _modelling_ (modélisation) est expliquée en détail dans la section suivante du guide.

Pour ajouter une source de données à un jeu de données, cliquez sur **Add a source**. Une fenêtre apparaît vous demandant d’entrer une URL. Indiquez l’URL du fichier CSV que vous avez précédemment publié sur le web comme indiqué dans la section précédente du guide et cliquez sur _**Create**_. Vous verrez alors une fenêtre bleue indiquant qu’OpenSpending est en train d’examiner les données.

![Ajouter des données étape 1](http://blog.openspending.org/files/2013/08/image_2-e1375888360807.png)

Cliquez sur _**Refresh**_ ou utilisez le bouton de rafraîchissement de votre navigateur. Si OpenSpending parvient à analyser vos données, vous verrez alors un message vert vous disant que les données sont prêtes. Vous devriez également voir une liste correcte des colonnes de votre CSV.

![Ajouter des données étape 2](http://blog.openspending.org/files/2013/08/image_3-e1375888381459.png)

Notez que si vous fournissez à OpenSpending un fichier HTML à la place d’un fichier CSV, l’application analysera quand même le HTML comme si c’était un CSV. Le résultat ressemblera à cela:

![Ajouter des données étape 3](http://blog.openspending.org/files/2013/08/image_4-e1375888407751.png)

Si vous avez ajouté une mauvaise source, ce n’est pas grave. Vous n’avez pas à utiliser cette source pour votre jeu de données final. OpenSpending demande un travail supplémentaire sur les données avant de pouvoir les publier. Ajoutez alors simplement la source correcte, et oubliez l’autre source.

&nbsp;

**Suivant**:[<a href="../modeliser-vos-donnees-dans-openspending/">Modéliser vos données dans OpenSpending</a>]

&nbsp;

**Précédent**: [<a href="../publier-les-donnees-sur-le-web/">Publier les données sur le web</a>]
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
section: help
lead: true
title: Créer une visualisation
authors:
- lombardoelisabetta
---
La plateforme OpenSpending permet de créer facilement des visualisations de données. Trois visualisations sont proposées: le BubbleTree, la TreeMap et la Table des agrégats.

Toutes les modélisations d’OpenSpending vous permettent de choisir une série de dimensions grâce auxquelles vous pouvez agréger vos données et les segmenter selon des propriétés de plus en plus précises. Chaque modélisation est créée de la même manière : en choisissant les dimensions à agréger et l’ordre dans lequel les segmenter.

Pour commencer à créer une modélisation, allez dans la page d’accueil du jeu de données et sélectionnez _**Create a visualisation**_ dans le menu _Visualization_.

###BubbleTree

Le BubbleTree est une visualisation interactive qui présente les données de dépense aggrégée sous forme de bulles. Chaque bulle représente un (sous-)total aggrégé. La bulle centrale représente la somme aggrégée et les bulles qui l’entourent représentent les autres sommes qui la composent. En cliquant sur n’importe quelle bulle, l’utilisation voit la manière dont la somme se divise en d’autres sous-totaux.

Pour créer un BubbleTree, choisissez les dimension d’agrégation et l’ordre dans lequel vous voulez les agréger. Choisissez la première dimension dans la liste déroulante Level. Vous verrez alors le total agrégé de cette dimension sous la forme de la bulle centrale, avec les valeurs des dimensions qui l’entourent et leurs propres totaux.

![Bumble Tree]({{ site.baseurl }}/img/blog/2013/08/image_14.png)

Pour ajouter un deuxième niveau, cliquez sur _**Add a level**_ et choisissez une nouvelle dimension. Les utilisateurs seront alors capables de cliquer sur les bulles pour les segmenter et voir comment les valeur du premier niveau se divisent dans les valeurs du second niveau.

![Bumble Tree]({{ site.baseurl }}/img/blog/2013/08/image_15.png)

###TreeMap

Le TreeMap représente les données de dépense agrégées sous forme de rectangle de couleur. Chaque rectangle représente un montant agrégé selon une dimension du jeu de données. Cliquer sur un rectangle permet d’explorer la répartition des sous-totaux suivant une autre dimension.

Pour créer un TreeMap, choisissez simplement les dimensions à agréger et leur niveau. En sélectionnant la dimension de premier niveau vous verrez apparaître la répartition des montants dans les rectangles suivant la dimension choisie.

![Tree Map]({{ site.baseurl }}/img/blog/2013/08/image_16.png)

Pour rendre la visualisation plus interactive, ajoutez des niveaux supplémentaires qui vous permettront d’explorer comment chaque montant se divise en sous-montants. Pour ajouter un second niveau, cliquez sur **Add a level** et choisissez une nouvelle dimension. Les utilisateurs peuvent désormais cliquer pour voir comment les montants se divisent.

![Visualisation interactive]({{ site.baseurl }}/img/blog/2013/08/image_17.png)

###Tableau d’agrégats

Le tableau d’agrégats est un simple tableau qui offre une vue des données numériques agrégées (additionnées) suivant la dimension choisie.

Sélectionnez une dimensions dans le menu _Columns_. Vous verrez alors apparâitre un tableau avec les montants et le pourcentage du montant total qu’ils représentent. Par défaut, les lignes sont triées par pourcentage décroissant.

![Tableau d’agrégats](http://blog.openspending.org/files/2013/08/image_18-e1375889043439.png)

En ajoutant une autre colonne en cliquant sur **Add a level**, le montant de la première colonne sera divisé en sous-totaux dans la seconde suivant la dimension sélectionnée. Notez que cette opération modifie les valeurs des pourcentages et donc l’ordre des lignes.

![Ajouter des colonnes](http://blog.openspending.org/files/2013/08/image_19-e1375889063736.png)

&nbsp;

**Suivant**:[<a href="../inclure-une-visualisation-sur-votre-site-web/">Inclure une visualisation sur votre site web</a>]

&nbsp;

**Précédent**: [<a href="../modeliser-vos-donnees-dans-openspending/">Modéliser vos données dans OpenSpending</a>]
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
section: help
lead: true
title: Formatter les données
authors:
- lombardoelisabetta
---
OpenSpending suppose que les données soient fournies dans un seul format simple.

###Fichier CSV

OpenSpending accepte les données dans un seul type de format de fichier, le format CSV (Comma-Separated Values). Un fichier CSV est un fichier texte qui représente les données sous la forme d’un tableau, similaire à un format tableur. Dans un tableau, chaque entrée est représentée par une ligne, et chaque propriété de l’entrée est représentée par une colonne. Dans un fichier CSV, les lignes sont subdivisées en colonnes à l’aide de virgules.

Les fichiers CSV acceptés par OpenSpending sont “dénormalisés”: cela signifie qu’ils n’économisent pas d’espace en supprimant des valeurs redondantes. Ils doivent également être “rectangulaires”, c’est-à-dire qu’ils ont exactement le même nombre de colonnes pour chacune des lignes.

###Le format OpenSpending

Un fichier CSV doit avoir les caractéristiques suivantes pour OpenSpending.

1. Une ligne de titre. La première ligne du fichier CSV devrait contenir les noms des colonnes, séparés par des virgules.
2. Au moins 3 colonnes : un montant, une date (qui peut être juste une année), et le payeur ou le bénéficiaire (qui peut juste être le nom d’un compte).
3. Des colonnes homogènes. Chaque colonne doit toujours représenter un seul type de valeur pour toutes les lignes (Il ne peut y avoir, par exemple, de sous-division).
4. Les lignes sont des points de données. Chaque ligne ne doit contenir qu’un type de données : une transaction ou une ligne budgétaire (elles ne peuvent représenter plusieurs transactions)
5. Aucune ligne ou cellule vide. Chaque ligne d’un fichier devrait contenir toutes les informations requises afin de pouvoir construire l’objet résultant.
6. Pas de résultats aggrégés (exemple : sous total ou calculs à l’aide de formules). Ils seront calculés automatiquement par OpenSpending.
7. Un identifiant unique. Il doit y avoir une colonne ou une combinaison de colonnes permettant d’identifier chaque ligne. La méthode la plus simple pour créer un tel identifiant est de créer une colonne supplémentaire dans laquelle vous ajoutez un chiffre qui s’incrémente à chaque ligne. Vous pouvez le faire dans Excel en ajoutant les deux premiers chiffres de la série, sélectionnez les deux cellules, et faire glisser le coin droit de la seconde cellule tout en bas du jeu de données pour étendre automatiquement la série. Si le jeu de données a trop de colonnes pour un logiciel comme Excel, vous pouvez utiliser [mySQL.](http://stackoverflow.com/questions/16113570/how-to-add-new-column-to-mysql-table "mySQL")
8. Les dates dans le bon format. Les dates doivent toutes être dans le format “aaaa-mm-jj”
9. Les nombres dans le bon format. Les nombres doivent contenir uniquement des chiffres et éventuellement un point (pas une virgule) pour séparer les décimales (un nombre écrit “12,345.67” devrait être converti en “12345.67”).

La communauté OpenSpending a rassemblé des [exemples](https://drive.google.com/a/okfn.org/#folders/0B_dkMlz2NopEbmRoTExsMDFMR2M "exemples de formatage de données") afin d’illustrer les «bons» et les «mauvais» exemples de formatage de jeux de données.

Voici des exemples de jeux de données **mal formattés**:

* [Plusieurs transactions, une ligne](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdG5kR0kzQ0E5V3BuTS16MndBT3dMdEE#gid=0 "Plusieurs transactions, une ligne") (plusieurs années sur une seule entrée)
* [Format de chiffre incorrect](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdEo1Y2p2R0VvdnJvRXMwUVREbHRoLXc#gid=0 "Format de chiffre incorrect") (les chiffres contiennent des virgules pour la lisibilité)

Voici des exemples de **bons** jeux de données:

* [Washington, DC](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdDhrZnRkWl9ZX2ZZNVptTzdueWw3emc#gid=0 "Données de dépenses de la ville de Washington D.C.") (données de dépenses)
* [Minsk, Biélorussie](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdEtIMFlEVDZXOWdDUEthUTQ0c21aV2c#gid=0 "Données budgétaires de la ville de Minsk") (données budgétaires)

&nbsp;

**Suivant**:[<a href="../publier-les-donnees-sur-le-web/">Publier les données sur le web</a>]

&nbsp;

**Précédent**: [<a href="../rassembler-les-donnees/">Rassembler les données</a>]
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
section: help
lead: true
title: Inclure une visualisation sur votre site web
authors:
- lombardoelisabetta
---
Il est très simple d’insérer dans votre site Web des visualisations créées grâce à OpenSpending. Votre site bénéficiera alors des visualisations interactives complètes.

Imaginons que vous ayez choisi une visualisation particulière sur la plateforme OpenSpending. Remarquez le bouton **Embed** en bas à droite de la page. En cliquant sur ce bouton, vous accédez au code nécessaire à l’inclusion de la visualisation sur votre site Web, ainsi qu’à quelques options concernant la taille (en pixels) de la visualisation interactive. Il ne vous reste qu’à copier et coller le code dans votre site. Si vous n’êtes pas sûr de savoir comment coller le code correctement, contactez l’administrateur de votre site.

L’inclusion de visualisations est rendue possible par les _widgets_. Ces morceaux de code que vous pouvez inclure dans une page Web récupèrent à distance des données — dans notre cas, depuis la base de données OpenSpending — sans que vous ayez à stocker vous-même ces données.

&nbsp;

**Précédent**:[<a href="../creer-une-visualisation/">Créer une visualisation</a>]

&nbsp;

**Début**: [<a href="../">Le Guide OpenSpending</a>]
41 changes: 41 additions & 0 deletions examples/openspending/content/help/guide/fr/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
section: help
lead: true
title: Le Guide OpenSpending
authors:
- Anders Pedersen
---
Le guide OpenSpending introduit le processus de découverte, recueil et usage des données sur la plateforme OpenSpending.

<strong>Introduction</strong>

<ul>
<li><a href="fr/quest-ce-que-openspending/">Qu’est ce que OpenSpending?</a></li>
<li><a href="fr/quels-types-de-donnees-financieres-peut-on-ajouter-dans-openspending/">Quels types de données financières peut-on ajouter dans OpenSpending?</a></li>
<li><a href="fr/representation-des-donnees-dans-openspending/">Représentation des données dans OpenSpending</a></li>
</ul>
<strong>Ajouter des données dans OpenSpending</strong>

<ul>
<li><a href="fr/ajouter-des-donnees-dans-openspending/">Ajouter les données</a></li>
<li><a href="fr/rassembler-les-donnees/">Rassembler les données</a></li>
<li><a href="fr/formatter-les-donnees/">Formatter les données</a></li>
<li><a href="fr/publier-les-donnees-sur-le-web/">Publier les données sur le web</a></li>
<li><a href="fr/creer-un-jeu-de-donnees-sur-openspending/">Créer un jeu de données sur OpenSpending</a></li>
<li><a href="fr/modeliser-vos-donnees-dans-openspending/">Modéliser vos données dans OpenSpending</a></li>
</ul>
<strong> Visualisation</strong>

<ul>
<li><a href="fr/creer-une-visualisation/">Créer une visualisation</a></li>
<li><a href="fr/inclure-une-visualisation-sur-votre-site-web/">Inclure une visualisation sur votre site web</a></li>
</ul>
&nbsp;

Début: [<a href="fr/quest-ce-que-openspending/">Qu’est ce que OpenSpending?</a>]

Up: [<a href=".fr/">Autres guides</a>]

&nbsp;

&nbsp;
Loading

0 comments on commit 8f4c134

Please sign in to comment.