diff --git a/examples/openspending/components/Header.tsx b/examples/openspending/components/Header.tsx index 639d36ff..93939cd0 100644 --- a/examples/openspending/components/Header.tsx +++ b/examples/openspending/components/Header.tsx @@ -57,6 +57,10 @@ export function Header() { title: 'Contributing', href: '/contributing', }, + { + title: 'Help', + href: '/help', + }, { title: 'Resources', href: '/resources', @@ -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', + }, ], }, ]; diff --git a/examples/openspending/content/help/guide/adding-data-overview/index.md b/examples/openspending/content/help/guide/en/adding-data-overview/index.md similarity index 100% rename from examples/openspending/content/help/guide/adding-data-overview/index.md rename to examples/openspending/content/help/guide/en/adding-data-overview/index.md diff --git a/examples/openspending/content/help/guide/create-viz/index.md b/examples/openspending/content/help/guide/en/create-viz/index.md similarity index 100% rename from examples/openspending/content/help/guide/create-viz/index.md rename to examples/openspending/content/help/guide/en/create-viz/index.md diff --git a/examples/openspending/content/help/guide/creating-dataset/index.md b/examples/openspending/content/help/guide/en/creating-dataset/index.md similarity index 100% rename from examples/openspending/content/help/guide/creating-dataset/index.md rename to examples/openspending/content/help/guide/en/creating-dataset/index.md diff --git a/examples/openspending/content/help/guide/data-model/index.md b/examples/openspending/content/help/guide/en/data-model/index.md similarity index 100% rename from examples/openspending/content/help/guide/data-model/index.md rename to examples/openspending/content/help/guide/en/data-model/index.md diff --git a/examples/openspending/content/help/guide/embed-viz/index.md b/examples/openspending/content/help/guide/en/embed-viz/index.md similarity index 100% rename from examples/openspending/content/help/guide/embed-viz/index.md rename to examples/openspending/content/help/guide/en/embed-viz/index.md diff --git a/examples/openspending/content/help/guide/financial-data-types/index.md b/examples/openspending/content/help/guide/en/financial-data-types/index.md similarity index 100% rename from examples/openspending/content/help/guide/financial-data-types/index.md rename to examples/openspending/content/help/guide/en/financial-data-types/index.md diff --git a/examples/openspending/content/help/guide/formatting-data/index.md b/examples/openspending/content/help/guide/en/formatting-data/index.md similarity index 100% rename from examples/openspending/content/help/guide/formatting-data/index.md rename to examples/openspending/content/help/guide/en/formatting-data/index.md diff --git a/examples/openspending/content/help/guide/gathering-data/index.md b/examples/openspending/content/help/guide/en/gathering-data/index.md similarity index 100% rename from examples/openspending/content/help/guide/gathering-data/index.md rename to examples/openspending/content/help/guide/en/gathering-data/index.md diff --git a/examples/openspending/content/help/guide/en/index.md b/examples/openspending/content/help/guide/en/index.md new file mode 100644 index 00000000..32208a71 --- /dev/null +++ b/examples/openspending/content/help/guide/en/index.md @@ -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) diff --git a/examples/openspending/content/help/guide/modelling-data/index.md b/examples/openspending/content/help/guide/en/modelling-data/index.md similarity index 100% rename from examples/openspending/content/help/guide/modelling-data/index.md rename to examples/openspending/content/help/guide/en/modelling-data/index.md diff --git a/examples/openspending/content/help/guide/publishing-data/index.md b/examples/openspending/content/help/guide/en/publishing-data/index.md similarity index 100% rename from examples/openspending/content/help/guide/publishing-data/index.md rename to examples/openspending/content/help/guide/en/publishing-data/index.md diff --git a/examples/openspending/content/help/guide/what-is-openspending/index.md b/examples/openspending/content/help/guide/en/what-is-openspending/index.md similarity index 100% rename from examples/openspending/content/help/guide/what-is-openspending/index.md rename to examples/openspending/content/help/guide/en/what-is-openspending/index.md diff --git a/examples/openspending/content/help/guide/esp/index.md b/examples/openspending/content/help/guide/esp/index.md new file mode 100644 index 00000000..1cc66e20 --- /dev/null +++ b/examples/openspending/content/help/guide/esp/index.md @@ -0,0 +1,10 @@ +--- +section: help +lead: true +title: Guía de OpenSpending (Gasto Abierto) +authors: +- Anders Pedersen +--- +Guía de OpenSpending (Gasto Abierto) (as a Google Doc). + +The guide needs to be reformatted and posted here (in markdown). You can help by getting in touch with the community here. diff --git a/examples/openspending/content/help/guide/fr/ajouter-des-donnees-dans-openspending/index.md b/examples/openspending/content/help/guide/fr/ajouter-des-donnees-dans-openspending/index.md new file mode 100644 index 00000000..403fe538 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/ajouter-des-donnees-dans-openspending/index.md @@ -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. + +  + +**Suivant**:[Rassembler les données] + +  + +**Précédent**: [Représentation des données dans OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/creer-un-jeu-de-donnees-sur-openspending/index.md b/examples/openspending/content/help/guide/fr/creer-un-jeu-de-donnees-sur-openspending/index.md new file mode 100644 index 00000000..0bd39dc5 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/creer-un-jeu-de-donnees-sur-openspending/index.md @@ -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. + +  + +**Suivant**:[Modéliser vos données dans OpenSpending] + +  + +**Précédent**: [Publier les données sur le web] diff --git a/examples/openspending/content/help/guide/fr/creer-une-visualisation/index.md b/examples/openspending/content/help/guide/fr/creer-une-visualisation/index.md new file mode 100644 index 00000000..e0417137 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/creer-une-visualisation/index.md @@ -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) + +  + +**Suivant**:[Inclure une visualisation sur votre site web] + +  + +**Précédent**: [Modéliser vos données dans OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/formatter-les-donnees/index.md b/examples/openspending/content/help/guide/fr/formatter-les-donnees/index.md new file mode 100644 index 00000000..46491ded --- /dev/null +++ b/examples/openspending/content/help/guide/fr/formatter-les-donnees/index.md @@ -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) + +  + +**Suivant**:[Publier les données sur le web] + +  + +**Précédent**: [Rassembler les données] diff --git a/examples/openspending/content/help/guide/fr/inclure-une-visualisation-sur-votre-site-web/index.md b/examples/openspending/content/help/guide/fr/inclure-une-visualisation-sur-votre-site-web/index.md new file mode 100644 index 00000000..a00e3566 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/inclure-une-visualisation-sur-votre-site-web/index.md @@ -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. + +  + +**Précédent**:[Créer une visualisation] + +  + +**Début**: [Le Guide OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/index.md b/examples/openspending/content/help/guide/fr/index.md new file mode 100644 index 00000000..0980275a --- /dev/null +++ b/examples/openspending/content/help/guide/fr/index.md @@ -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. + +Introduction + + +Ajouter des données dans OpenSpending + + + Visualisation + + +  + +Début: [Qu’est ce que OpenSpending?] + +Up: [Autres guides] + +  + +  diff --git a/examples/openspending/content/help/guide/fr/modeliser-vos-donnees-dans-openspending/index.md b/examples/openspending/content/help/guide/fr/modeliser-vos-donnees-dans-openspending/index.md new file mode 100644 index 00000000..d1286b41 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/modeliser-vos-donnees-dans-openspending/index.md @@ -0,0 +1,82 @@ +--- +section: help +lead: true +title: Modéliser vos données dans OpenSpending +authors: +- lombardoelisabetta +--- +Pour charger vos données dans OpenSpending, vous devez construire un modèle de vos données. Un modèle définie comment les données seront comprises par OpenSpending. L’application représente les propriétés des données en termes de _dimensions_. Modéliser les données consiste à lister les dimensions que vous souhaitez inclure dans le jeu de données OpenSpending et définir pour chaque dimension la ou les colonnes correspondantes dans le jeu de données d’origine. + +###Dimensions obligatoires : montant et date + +Chaque modèle nécessite au moins deux dimensions : un montant et une date. Elles spécifient la taille de la transaction et le moment de sa réalisation. Le montant et la date sont associés à des indicateurs spécifiques. Le montant est représenté par un indicateur de mesure et le temps est représenté par une date. Des dimensions génériques ne peuvent pas représenter ces valeurs particulières. + +Lorsque vous modélisez vos données, ce n’est pas une mauvaise idée de commencer par les dimensions obligatoires. Tout d’abord, cliquez sur le menu _**Dimensions & Measures**_ au sein de la page _**Manage the dataset**_ de votre jeu de données. + +![Dimensions obligatoires](http://blog.openspending.org/files/2013/08/image_5-e1375888673131.png) + +Après, cliquez sur _**Add Dimension**_ pour faire apparaître le panneau _Add new dimension_. Cliquez sur la case correspondant à _Date_. Vous verrez la fenêtre _Name_ automatiquement complétée avec la date, comme ci-dessous. Cliquez sur le bouton vert _**Add**_. + +![Ajouter une nouvelle dimension](http://blog.openspending.org/files/2013/08/image_6-e1375888703851.png) + +Le prochain écran que vous verrez vous donnera des informations sur la signification du temps. Dans la liste déroulante à coté de _Column_, sélectionnez la colonne de vos données qui représentera la valeur du temps. + +![Temps](http://blog.openspending.org/files/2013/08/image_7-e1375888730762.png) + +Quand vous avez identifié la colonne du temps, cliquez sur _**Add Dimension**_ encore une fois pour ajouter le montant. Cette fois-ci, sélectionnez la case correspondant à _Measure_, qui sera automatiquement complétée sous le nom “montant” et cliquez sur _**Add**_. Choisissez la colonne représentant la valeur de la transaction dans la liste déroulante à côté de _Column_. + +###Autre dimension indispensable: l’identifiant + +Il y a une autre dimension nécessaire au fonctionnement du modèle: la dimension (ou groupe de dimensions) dont la valeur identifie de manière unique chaque entrée de données, la clé. + +Une entrée peut être identifiée aussi par une combinaison de plusieurs colonnes, une _dimension composée_. Étant donné que les clés peuvent être composées, le type “dimension composée” doit être utilisé pour les répresenter, même si votre clé en l’occurrence n’est pas composée. + +La dimension clée peut être assignée en cliquant sur **Add Dimension** et ensuite en sélectionnant le bouton radio _Dimension_. + +Ajoutez le nom de votre clé, par exemple “clé”, dans la case appropriée. Cliquez sur **Add**. Cochez la case _include in unique_ afin d’identifier cette dimension en tant que partie de votre clé. + +On passe maintenant à la liste de **Fields**, qui contient deux rangées nommées _name_ (nom) et _label_ (étiquette). Une dimension composée peut contenir un nombre arbitraire de champs _(fields)_, chacun ayant un nom et un type et pouvant être associé à une colonne dans vos données. Cela nous permet d’expliquer le sens du mot “composé” dans ce contexte: les dimensions sont “composées” car elles regroupent plusieurs colonnes de données dans une seule propriété du jeu de données. + +![Dimensions composées](http://blog.openspending.org/files/2013/08/image_8-e1375888755790.png) + +Une dimension composée nécessite au moins deux champs, _name_ et _label_. Ces derniers doivent être de type _id_ et _string_. Le nom de la dimension est utilisé afin de fournir à cette dernière une URL opérationnelle et l’étiquette _(label)_ est utilisée pour présenter la dimension au sein de l’interface. + +Pour créer une dimension composée minimale, il suffit d’associer la même colonne de vos données d’origine avec le nom _(name)_ et l’étiquette _(label)_. Choisissez la colonne appropriée pour chacun et laissez les options sous “types” unchangées. + +###Mesures et autres dimensions + +Avec un montant, une date et un identifiant, votre modèle est suffisamment riche. Toutefois, un modèle parfaitement abouti devrait inclure une dimension pour chaque caractéristique importante du jeu de données d’origine. Suivre certaines conventions est alors utile. + +Une pratique courante dans la présentation des jeux de données d’origine est la segmentation de l’information qui caractérise chaque donnée sur de multiples colonnes. L’information concernant un compte associé à une transaction peut être réparti entre une colonne “Compte” qui identifie le montant chiffré et une colonne “Description du compte” qui donne une description écrite. L’image ci-dessous illustre cette pratique avec les colonne “Head-account” et “Sub-account”. + +![Head-accounts et sub-accounts]({{ site.baseurl }}/img/blog/2013/08/image_9.png) + +Les dimensions composées d’OpenSpending sont conçues pour modéliser ce type d’informations éparpillées. Pour ce faire, ajoutez une nouvelle dimension composée et associez chaque colonne à l’un des champs de la dimension. Essayez de faire correspondre une colonne aux commentaires très détaillés à label et une colonne plus concise à _name_. Dans l’image ci-dessous “Head-account” correspond à _name_ et “Head-account description” à _label_. + +![Head-account](http://blog.openspending.org/files/2013/08/image_10-e1375888789463.png) + +Certaines colonnes de votre base de données sont plus indépendantes, représentant certaines propriétés particulières de chaque donnée. Par exemple, une colonne qui attribue à chaque transaction une catégorie rentre dans ce cadre. Dans l’image ci-dessous, les colonnes _Reporting Type_, _Revenue/Expenditure_ et _Recurrent/Investment_ sont de ce type. + +![Propriétés des données]({{ site.baseurl }}/img/blog/2013/08/image_11.png) + +Les colonnes indépendantes qui spécifient des propriétés ou des catégories sont mieux modélisées avec des dimensions d’attribut. Un attribut est essentiellement une dimension qui ne connaît qu’un seul champ, quel que soit son type. Pour créer un attribut, sélectionnez simplement la case _Attribute_ quand vous ajoutez une dimension. + +![Attribute](http://blog.openspending.org/files/2013/08/image_12-e1375888823415.png) + +###Pour finir : sauvegarder et charger + +Lorsque chaque dimension a été spécifiée et reliée aux colonnes dans les données source, cliquez sur **Save Dimensions** pour sauvegarder votre modèle. En cas d’erreurs, un message apparaîtra, vous demandant de corriger certains paramètres. S’il n’y a pas d’erreurs, vous serez rédirigé vers le Dashboard, où vous pourrez charger vos données. + +Une fois que les données ont été téléchargées, le modèle que vous avez créé sera figé et vous n’aurez plus la possibilité de l’éditer. C’est pourquoi il est préférable de tester le modèle avant de télécharger les données. Pour ce faire, cliquez sur **Test a sample** dans votre tableau de sources de données. Attendez quelques secondes et rechargez la page. Si vous voyez un message indiquant COMPLETE sur un fond vert, alors votre modèle est prêt. Si vous voyez un message indiquant ERRORS, des corrections sont nécessaires. + +![Sauvegarder et charger](http://blog.openspending.org/files/2013/08/image_13-e1375888848457.png) + +Si votre modèle ne contient plus d’erreurs, cliquez sur **Load** pour charger le jeu de données source et lui appliquer le modèle. Vous pouvez ensuite retourner sur la page d’accueil du jeu de données en cliquant sur son nom en haut de l’écran et créer des visualisations ou explorer le jeu de données. + +  + +**Suivant**:[Créer une visualisation] + +  + +**Précédent**: [Créer un jeu de données sur OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/publier-les-donnees-sur-le-web/index.md b/examples/openspending/content/help/guide/fr/publier-les-donnees-sur-le-web/index.md new file mode 100644 index 00000000..edc7b124 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/publier-les-donnees-sur-le-web/index.md @@ -0,0 +1,35 @@ +--- +section: help +lead: true +title: Publier les données sur le web +authors: +- lombardoelisabetta +--- +Les données ne peuvent pas encore être téléchargées directement sur OpenSpending. Pour publier des données, celles-ci doivent mises à disposition sur le web. + +###Google Drive + +Vous pouvez mettre vos données à disposition sur le web en utilisant Google Drive spreadsheet. + +1. Importez vos données dans Google Drive. Créez une nouvelle feuille de calcul sur Google Drive, sélectionnez ensuite _Importer_ depuis le menu Fichier. Sélectionnez _Remplacer la feuille de calcul_, cliquez **Choose File**, et choisissez votre fichier CSV. Ensuite, cliquez sur Importer. +2. Assurez-vous que Google Docs formatte correctement votre jeu de données. Sélectionnez la colonne qui contient les dates. Cliquez sur le menu _Format_ et sélectionnez _Nombre -> Autre formats -> 2008-09-26_. Vos dates devraient apparaître dans le format **aaaa-mm-jj** utilisé par OpenSpending. +3. Cliquez sur le menu _Fichier_ et sélectionnez _Publier sur le web_ ... Dans la fenêtre qui apparaît, cliquez sur **Démarrer la publication**. En dessous, dans la section Insérer un lien vers les données publiées, sélectionnez **CSV (valeurs séparées par des virgules)**. L’URL en bas est celle de votre jeu de données. + +![Publier sur Google Drive]({{ site.baseurl }}/img/blog/2013/08/image_0.png) + +###Gist +GitHub Gist est un moyen très pratique pour héberger des fichiers textes de petite taille, notamment des fichiers CSV. + +1. Connectez-vous à GitHub (ou enregistrez-vous si vous ne l’avez pas déjà fait), allez ensuite sur [gist.github.com](https://gist.github.com "Gist"). +2. Cliquez et déplacez votre fichier CSV depuis le répertoire sur votre ordinateur vers la page GitHub Gist dans votre navigateur. Le nom du fichier et son contenu apparaîtront. +3. Cliquez sur _**Create Public Gist**_ pour être redirigé sur la page d’accueil de votre nouveau gist. L’URL de votre jeu de données est accessible via le bouton “” dans le coin en haut à droite du fichier. + +![Publier sur Gist](http://blog.openspending.org/files/2013/08/image_1-e1375888253802.png) + +  + +**Suivant**:[Créer un jeu de données sur OpenSpending] + +  + +**Précédent**: [Formatter les données] diff --git a/examples/openspending/content/help/guide/fr/quels-types-de-donnees-financieres-peut-on-ajouter-dans-openspending/index.md b/examples/openspending/content/help/guide/fr/quels-types-de-donnees-financieres-peut-on-ajouter-dans-openspending/index.md new file mode 100644 index 00000000..cc2dceee --- /dev/null +++ b/examples/openspending/content/help/guide/fr/quels-types-de-donnees-financieres-peut-on-ajouter-dans-openspending/index.md @@ -0,0 +1,49 @@ +--- +section: help +lead: true +title: Quels types de données financières peut-on ajouter dans OpenSpending? +authors: +- lombardoelisabetta +--- +OpenSpending est très flexible et admet de nombreux type de données financières. Et si le projet OpenSpending s’intéresse en particulier aux données financières des gouvernements, cela n’est pas une limitation technique. OpenSpending supporte ainsi n’importe quel jeu de données contenant une liste de transactions associées à une quantité monétaire et à une date. + +La plupart des données actuellement hébergées sur OpenSpending sont des données budgétaires ou bien des données transactionnelles. La principale différence entre ces deux types de données est leur granularité. Les données transactionnelles portent sur des transactions uniques réalisées, alors que les données budgétaires sont des données de dépenses aggrégées par catégories. + +###Les données de transactions financières + +Les données transactionnelles, ou plus simplement les “données de dépense”, renseignent sur les transactions financières. Chaque paiement d’une entité à une autre entité pour une date donnée et avec un objet particulier (un projet, un service, etc.) est alors renseigné. + +Les informations agrégées (ex: un sous-total de transactions) ne devraient pas être incluses dans les données de transactions. Les données qui ont été partiellement ou complétement agrégées ne peuvent pas être analysées de la même manière et devraient donc être traitées comme des données budgétaires plutôt que comme des données transactionnelles. En revanche, si plusieurs paiements ont été effectués à différentes dates pour régler une même dépense, ceux-ci devraient pouvoir être agrégés pour représenter une transaction unique. + +Exemples de données transactionnelles sur OpenSpending: + +* [Contrats publics Washington D.C.](http://openspending.org/dc-vendors-contractors/ "Contrats publics Washington D.C.") +* [Agence de Développement Autrichienne.](http://openspending.org/ada/ "Agence de Développement Autrichienne") + +Un autre type de données concerne les marchés publics. Les données sur les marchés publics informent sur l’objet du marché, le montant du marché, et qui a remporté le marché. Les données des marchés publics peuvent être considérées comme un sous-type de données transactionnelles (dans le cas où il s’agit d’un marché réalisé). + +Exemples de données sur les marchés publics sur OpenSpending: + +* [Marchés publics au Sénégal.](http://openspending.org/marches-publics-senegal/views/liste-des-attributaires "Marchés publics au Sénégal") +* [Marchés publics France 2011.](http://openspending.org/marches-publics-france-2011 "Marchés publics France 2011") + +###Les données budgétaires + +Pour les données budgétaires, les dépenses et les recettes sont agrégées par catégories. L’objectif de ces aggrégations est d’aider le lecteur à comprendre le budget, qui est habituellement un document de politique publique utilisé pour donner au lecteur un aperçu des choix financiers les plus importants du gouvernement. Les fonds alloués sont habituellement structurés en fonction de secteurs plutôt qu’en fonction des actuels bénéficiaires. + +Les données budgétaires présentent généralement à la fois les recettes et dépenses passées et le budget prévisionnel. Ainsi, les montants des dépenses pour les années précédentes dans un secteur particulier donnent une indication sur les fonds qui devrait être attribués pour la période suivante. Les données budgétaires sont en général composées de données agrégées et d’estimations statistiques. + +Les pays publient différents types d’informations budgétaires, incluant : le pré-budget, la proposition de budget (projet de loi de Finance), le budget ratifié, et le budget citoyen (qui est une version simplifiée du budget pour une meilleure compréhension par les citoyens). + +Des exemples de données budgétaires sur OpenSpending: + +* [Budget de la ville de Berlin.](http://openspending.org/berlin_de "Budget de la ville de Berlin") +* [Budget de la ville de Séville.](http://openspending.org/seville-budget "Budget de la ville de Séville") + +  + +**Suivant**:[Représentation des données dans OpenSpending] + +  + +**Précédent**: [Qu’est ce que OpenSpending?] diff --git a/examples/openspending/content/help/guide/fr/quest-ce-que-openspending/index.md b/examples/openspending/content/help/guide/fr/quest-ce-que-openspending/index.md new file mode 100644 index 00000000..de6b8488 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/quest-ce-que-openspending/index.md @@ -0,0 +1,18 @@ +--- +section: help +lead: true +title: Qu’est ce que OpenSpending? +authors: +- lombardoelisabetta +--- +OpenSpending est une application web et une communauté de contributeurs dont l’objectif est de répertorier toutes les transactions financières des entreprises et gouvernements à travers le monde et présenter ces données de manière utile et engageante. OpenSpending est un projet ouvert maintenu par la communauté. Toutes les personnes intéressées par les données financières de toutes sortes sont invitées à contribuer à la base de données OpenSpending, à créer des visualisations en utilisant l’application OpenSpending, et à utiliser l’API OpenSpending. + +Ce chapitre introduit les concepts principaux du système aux nouveaux contributeurs d’OpenSpending. Il décrit les différents types de données financières que OpenSpending supporte, et explique comment l’application représente les données. + +  + +**Suivant**:[Quels types de données financières peut-on ajouter dans OpenSpending?] + +  + +**Précédent**: [Le Guide OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/rassembler-les-donnees/index.md b/examples/openspending/content/help/guide/fr/rassembler-les-donnees/index.md new file mode 100644 index 00000000..66d83164 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/rassembler-les-donnees/index.md @@ -0,0 +1,20 @@ +--- +section: help +lead: true +title: Rassembler les données +authors: +- lombardoelisabetta +--- +Pour ajouter un jeu de données sur OpenSpending, vous devez déjà avoir des données à disposition. Si ce n’est pas le cas, vous devrez chercher une source de données sur le web (ou en ajouter une). + +Commencez votre recherche en consultant les ressources telles que [School of Data](http://schoolofdata.org/handbook/courses/finding-data/ "School of data") (en anglais) ou le [Guide du Datajournalisme](http://jplusplus.github.io/guide-du-datajournalisme/ "Guide du Datajournalisme"). Consultez également les sources officielles de données telles que [data.gouv.fr](http://www.data.gouv.fr "Données officielles du gouvernement français"). Vous pouvez également trouver de l’aide et des idées en vous rendant sur le groupe [OpenSpending](http://datahub.io/group/openspending "OpenSpending") sur datahub.io, ou en posant des questions sur le channel IRC #openspending sur Freenode. + +Si les données trouvées ne sont pas dans un format lisible par une machine, comme un fichier Excel ou CSV, mais dans un format du type PDF ou Word, il sera très difficile de travailler avec. Vous devriez alors peut être penser à essayer avec d’autres données. + +  + +**Suivant**:[Formatter les données] + +  + +**Précédent**: [Ajouter des données dans OpenSpending] diff --git a/examples/openspending/content/help/guide/fr/representation-des-donnees-dans-openspending/index.md b/examples/openspending/content/help/guide/fr/representation-des-donnees-dans-openspending/index.md new file mode 100644 index 00000000..8cbd5a89 --- /dev/null +++ b/examples/openspending/content/help/guide/fr/representation-des-donnees-dans-openspending/index.md @@ -0,0 +1,32 @@ +--- +section: help +lead: true +title: Représentation des données dans OpenSpending +authors: +- lombardoelisabetta +--- +OpenSpending contient une collection de jeux de données, dont chacun provient d’une source différente. Dans un jeu de données, chaque transaction est représentée par une liste d’entrées (ou attributs). Chaque jeu de données a son propre modèle de structure de données. Un modèle décrit les propriétés d’un jeu de données en termes de dimensions. + +###Jeu de données + +L’unité de base dans OpenSpending est le jeu de données. Les données financières partageant un sujet commun (un budget pour une ville, le budget d’une année) sont regroupées ensemble et enregistrées dans un jeu de données. Un jeu de données est une collection d’ «entrées», et chaque entrée représente une transaction unique associée à un montant et à une date. + +Un jeu de données inclut également des métadonnées pour décrire son contenu. Les métadonnées contiennent une description du jeu de données, des informations sur la source des données, et d’autres informations qui peuvent aider l’utilisateur à trouver et interpréter le contenu de ce jeu de données. + +###Modèle + +Le créateur d’un jeu de données a la maîtrise compléte sur la structure du jeu de données. Cette structure est créée en définissant un modèle qui est composé de dimensions. + +Une dimension est une propriété qui définit une entrée du jeu de données. En considérant qu’un jeu de données est un tableau, les dimensions peuvent alors être assimilées aux colonnes. Cependant, une dimension peut avoir une structure plus complexe qu’une seule colonne. + +Les dimensions sont de différentes natures. La plus importante étant celle de type _**measure**_ (montant). Une _measure_ est une dimension qui contient une valeur numérique. Une autre dimension importante est celle de type _**time_** (temps), qui représente la date et l’heure. Chaque entrée nécessite au moins une dimension _measure_ et une dimension _time_, représentant respectivement le montant et la date d’une transaction. + +Les autres dimensions sont utilisées pour représenter d’autres propriétés du jeu de données, telles que le numéro de la transaction, le type de la transaction, le nom de l’administration et le nom de la société ou l’individu impliqué. Ces dimensions incluent des _**attributes**_ (attributs), qui contiennent une valeur unique, et les _**compound dimensions**_ (dimensions composées), qui peuvent contenir plusieurs valeurs. Les dimensions composées peuvent être utiles lorsqu’une propriété est définie par plusieurs autres propriétés. + +  + +**Suivant**:[Ajouter des données dans OpenSpending] + +  + +**Précédent**: [Quels types de données financières peut-on ajouter dans OpenSpending?] diff --git a/examples/openspending/content/help/guide/index.md b/examples/openspending/content/help/guide/index.md index abf1ee32..3fe513b3 100644 --- a/examples/openspending/content/help/guide/index.md +++ b/examples/openspending/content/help/guide/index.md @@ -5,23 +5,16 @@ 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. +The OpenSpending Guide is the complete manual for OpenSpending. Whether you wish to find, clean, add, or use spending data with OpenSpending we've got you covered. -* Introduction - * [What is OpenSpending?](./what-is-openspending) - * [What types of financial data can go into OpenSpending?](./financial-data-types) - * [How does OpenSpending represent data?](./data-model) -* Adding Data to OpenSpending - * [Overview](./adding-data-overview) - * [Gathering data](./gathering-data) - * [Formatting data](./formatting-data) - * [Publishing data on the web](./publishing-data) - * [Creating a dataset on OpenSpending](./creating-dataset) - * [Modelling your data in OpenSpending](./modelling-data) -* Visualizations - * [Create a visualization](./create-viz) - * [Embed a visualization on your website](./embed-viz) +The OpenSpending Guide is available in multiple languages: -**Begin**: [What is OpenSpending?](./what-is-openspending/) +* [English](guide/en) +* [French](guide/fr) +* [Italian](guide/it) +* [Romanian](guide/rom) +* [Spanish](guide/esp) +* [Turkish](guide/tur) (still in progress) +* Add your language by translating the guide available in this Google Doc! -**Up**: [OpenSpending guides](../) +**Up**: [OpenSpending help](../) diff --git a/examples/openspending/content/help/guide/it/aggiungere-dati-ad-openspending/index.md b/examples/openspending/content/help/guide/it/aggiungere-dati-ad-openspending/index.md new file mode 100644 index 00000000..f0fd909b --- /dev/null +++ b/examples/openspending/content/help/guide/it/aggiungere-dati-ad-openspending/index.md @@ -0,0 +1,28 @@ +--- +section: help +lead: true +title: Aggiungere dati +authors: +- stefanobandera +--- +Uno dei contributi più importanti per il progetto OpenSpending è quello di aggiungere un nuovo dataset. Questa sezione della guida vi spiegherà il processo tramite cui aggiungere nuovi dati. + +Un flusso di lavoro tipico per l'importazione di un insieme di dati in OpenSpending prevede le seguenti fasi: + +* raccogliere dati leggibili da una fonte attendibile + +* Convertire i dati in un file CSV nel formato atteso dal OpenSpending, pulendolo per rimuovere incongruenze ed errori + +* Pubblicare i dati sul web + +* Creare un dataset aggiungendo i dati pubblicati come nuova fonte + +* Modella il dataset per assegnare un ruolo ad ogni colonna presente nella tabella di origine + +* Caricare o rifinisci i dati in base al feedback fornito dalla piattaforma, in base alla coerenza dei propri dati. + +Ognuno di questi passi sarà spiegato in dettaglio nelle seguenti sezioni. + +**Prossimo** [Raccolta dati] + +**Precedente** [Come vengono rappresentati i dati su OpenSpending?] diff --git a/examples/openspending/content/help/guide/it/come-vengono-rappresentati-i-dati-su-openspending/index.md b/examples/openspending/content/help/guide/it/come-vengono-rappresentati-i-dati-su-openspending/index.md new file mode 100644 index 00000000..9b294c25 --- /dev/null +++ b/examples/openspending/content/help/guide/it/come-vengono-rappresentati-i-dati-su-openspending/index.md @@ -0,0 +1,26 @@ +--- +section: help +lead: true +title: Come vengono Rappresentati i dati su OpenSpending +authors: +- stefanobandera +--- +OpenSpending mantiene una collezione di dataset, ciascuna delle quali rappresenta un insieme di dati derivanti da una sorgente separata. All'interno di ogni set di dati, le transazioni individuali sono rappresentate da un insieme di voci. Ogni set di dati ha un modello proprio che mappa la struttura dei dati stessi. Il modello codifica le proprietà di ogni set in termini di dimensioni. + +#### Dataset + +L'unità di base del sistema OpenSpending è il dataset. Le transazioni finanziarie che condividono un tema comune (ad esempio, la spesa di una particolare città, un bilancio per un determinato anno) vengono raggruppate e memorizzate come un set di dati. Un dataset è una raccolta di "voci", e ogni voce rappresenta una singola transazione associata ad una quantità di soldi e ad un periodo di tempo. + +### Modelli + +La struttura di ogni dataset dipende completamente dal suo creatore. Questa struttura viene creata specificando un modello che fornisce le dimensioni lungo le quali i vari item possono differire l'uno dall'altro. + +Un modello consiste in un insieme di dimensioni. Una dimensione è una proprietà che potenzialmente differenzia una voce da un’ altra. Se pensate ad un dataset come un foglio di calcolo, ciascuna dimensione può essere pensata come una colonna. Tuttavia le dimensioni possono avere più struttura di una normale colonna del foglio di calcolo. + +Le dimensioni sono di diversi tipi. La più importante è il tipo di misura. Le misure sono dimensioni che possono contenere un singolo valore numerico. Un' altra importante tipologia di dimensione è il tempo, che rappresenta date e orari. Ogni dato necessita di almeno una misura e una dimensione di tempo, che rappresentano rispettivamente la quantità di denaro presente nella transazione e il momento in cui ha avuto luogo. + +Le rimanenti tipologie di dimensioni sono utilizzate per rappresentare altre proprietà che gli item potrebbero avere, ad esempio: numeri di transazione, etichette provenienti da uno schema di classificazione,, oppure i nomi delle persone o le società coinvolte. Tali dimensioni comprendono gli attributi, che possono contenere un singolo valore, e le dimensioni composte, che possono contenere un insieme nidificato di valori. Le dimensioni composte sono utili quando una proprietà include diverse sotto-proprietà che potrebbero essere utilizzate per aggregare i dati. + +**Prossimo** [Aggiungere dati ad OpenSpending] + +**Precedente** [Quali tipi di dati finanziari entrano in OpenSpending?] diff --git a/examples/openspending/content/help/guide/it/cose-openspending/index.md b/examples/openspending/content/help/guide/it/cose-openspending/index.md new file mode 100644 index 00000000..dade3dea --- /dev/null +++ b/examples/openspending/content/help/guide/it/cose-openspending/index.md @@ -0,0 +1,14 @@ +--- +section: help +lead: true +title: Cos'è OpenSpending? +authors: +- stefanobandera +--- +OpenSpending è una comunità di condivisione dati e applicazioni web che mira a tracciare ogni transazione finanziaria di governi e aziende di tutto il mondo, presentando i dati in una forma utile e coinvolgente. OpenSpending è un progetto* open* gestito da una comunità di contributori. Chiunque sia interessato a sfruttare dati di qualsiasi tipo è invitato a contribuire al database OpenSpending, a creare visualizzazioni con il software OpenSpending, e a utilizzare le API messe a disposizione. + +Questo capitolo introduce i nuovi collaboratori OpenSpending ai concetti fondamentali del sistema. Esso descrive il tipo di dati finanziari che OpenSpending supporta, e spiega come vengano rappresentati i dati. + +**Prossimo** [Quali tipi di dati entrano in OpenSpending?] + +**Precedente** [Guida ad OpenSpending] diff --git a/examples/openspending/content/help/guide/it/crea-una-visualizzazione/index.md b/examples/openspending/content/help/guide/it/crea-una-visualizzazione/index.md new file mode 100644 index 00000000..7eba754b --- /dev/null +++ b/examples/openspending/content/help/guide/it/crea-una-visualizzazione/index.md @@ -0,0 +1,52 @@ +--- +section: help +lead: true +title: Crea una visualizzazione +authors: +- stefanobandera +--- +La piattaforma OpenSpending rende facile creare e incorporare visualizzazioni di set di dati. Sono supportati tre tipi di visualizzazioni: BubbleTree, TreeMap, e la tabella di aggregati. + +Tutte le visualizzazioni presenti in OpenSpending permettono di scegliere una serie di dimensioni lungo le quali aggregare i dati, aumentando il livello di particolarità qualora ve ne sia bisogno. Ogni visualizzazione viene creata nello stesso modo: con la scelta delle dimensioni da aggregare e l'ordine in cui eseguire il drill down. + +Per iniziare a creare una visualizzazione, vai alla home page di un dataset e seleziona **Create a visualization** dal Visualizations menu. + +**BubbleTree** + +Il BubbleTree è una visualizzazione interattiva che presenta i dati di spesa aggregati come un cerchio a bolle. Ogni bolla rappresenta un aggregato (sub) totale. La bolla centrale rappresenta una somma aggregata, e le sue bolle circostanti rappresentano le altre somme da cui è composta. Cliccando su ogni bolla, viene mostrato all'utente come la somma si divida ulteriormente in sub-totali . + +Per creare un BubbleTree, scegli le dimensioni da aggregare e l'ordine in cui aggregarle. Scegli la dimensione primaria dal menu a cascata. Si vedrà il totale aggregato per quella dimensione, come la bolla centrale, con i singoli valori totali che la circondano. + +image_14 + +Per aggiungere un secondo livello, clicca su Add a level e scegli una nuova dimensione. Gli utenti saranno ora in grado di fare clic su le bolle di "drill-down" e vedere come i valori del primo livello si suddividono in i singoli valori totali nel secondo livello. + +image_15 + +**TreeMap** + +Il TreeMap presenta i dati di spesa aggregati come un rettangolo interattivo composto da rettangoli colorati. Ogni rettangolo rappresenta valori aggregati per una particolare dimensione dei dati. Cliccando su "zooms in" si mostra come è possibile scomporre ed esplorare le dimensioni aggregate. + +Per creare un TreeMap, basta scegliere le dimensioni da aggregare e il loro ordine. Seleziona la dimensione primaria dal menu *Tile*. Vedrai un TreeMap che mostra come la spesa totale scompone attraverso quella dimensione. + +image_16 + +La visualizzazione non è ancora interattiva . L'aggiunta di ulteriori livelli ci mostra come sia possibile scomporre ed esplorare le dimensioni aggregate, permettendo di visualizzare in dettaglio come valori aggregati si scompongano in unità più piccole. Per aggiungere un secondo livello di rettangoli, clicca su **Add a level** e scegli una nuova dimensione. Gli utenti possono ora scegliere i rettangoli con i quali dividere il totale. + +image_17 + +### Table of Aggregates + +La tabella di aggregati è una semplice rappresentazione tabellare di un dataset che aggrega i totali delle dimensioni scelte. Una tabella di aggregati si specifica scegliendo dimensioni da inserire nelle sue colonne. + +La scelta di una dimensione primaria tramite il *Column menu* visualizza i dati in forma di tabella, con importi aggregati e percentuali del totale complessivo. Di default, le righe verranno ordinati in base a valori percentuali. + +image_18 + +Aggiungendo un'altra colonna, cliccando su Add a level, si rompe ogni subtotale presente nella prima colonna tramite le somme aggregati della nuova colonna. Nota che questo in genere cambia i valori percentuali e riorganizza le righe della tabella. + +image_19 + +**Prossimo** [Inserisci una visualizzazione nel tuo sito web] + +**Precedente** [Modellare i tuoi dati su OpenSpending] diff --git a/examples/openspending/content/help/guide/it/creare-un-dataset-su-openspending/index.md b/examples/openspending/content/help/guide/it/creare-un-dataset-su-openspending/index.md new file mode 100644 index 00000000..2398e534 --- /dev/null +++ b/examples/openspending/content/help/guide/it/creare-un-dataset-su-openspending/index.md @@ -0,0 +1,54 @@ +--- +section: help +lead: true +title: Creare un dataset su OpenSpending +authors: +- stefanobandera +--- +Per iniziare la condivisione dei dati sulla piattaforma OpenSpending, registrati su OpenSpending.org e crea un nuovo OpenSpending dataset. Per creare un set di dati, è sufficiente compilare alcuni metadati, che caratterizzano i propri dati, e fornire l'URL in cui i dati sono ospitati. + +**Crea un nuovo dataset** + +Accedi OpenSpending.org con le informazioni utente, o registrati se non l'hai ancora fatto. Arriverai alla Dashboard, dove vedrai un pulsante blu etichettato *Import a dataset. *Fai clic qui per avviare la creazione di un nuovo insieme di dati su OpenSpending. + +La schermata successiva richiede di fornire i metadati che contraddistinguono i tuoi dati. Questo include i seguenti campi: + +* *Title*: un nome descrittivo e significativo per il dataset. Può essere qualsiasi stringa. + +* *Identifier*: un titolo più breve, utilizzato come parte dell'URL del dataset. Può contenere solo caratteri alfanumerici, trattini e underscore - senza spazi o segni di punteggiatura. + +* *Category*: "Bilancio", "spese", e "Altro". Vedi la sezione guida riguardo i tipi di dati finanziari per i dettagli su queste categorie. + +* Currency: la valuta in cui la spesa descritta dal dataset ha luogo. + +* Paesi: l'elenco dei paesi di riferimento nel dataset. La scelta degli Stati è limitata da un elenco di paesi validi. + +* Languages: l'elenco delle lingue utilizzate nel dataset. La scelta delle lingue è limitata da un elenco di lingue valide. + +* Description: una caratterizzazione del dataset in semplice prosa. Può essere qualsiasi stringa. + +Compila tutti questi campi. Assicurati di includere una descrizione che spieghi l'origine del dataset e riconosca tutte le modifiche introdotte (ad esempio, le operazioni di pulizia che hai fatto). + +Una volta che tutti i metadati sono state inseriti, premi **Next Step **per procedere. + +**Aggiungere una nuova fonte di dati** + +Facendo clic su *next step* viene creato il tuo nuovo dataset OpenSpending che ti conduce alla pagina di Gestione. La pagina Gestione viene utilizzata per aggiungere sorgenti dati. E' utilizzato anche per fornire informazioni schematiche che permettono ad OpenSpending di interpretare i dati, un processo chiamato "modelling" che verrà trattato nella prossima sezione della guida. + +Per aggiungere una fonte di dati al dataset, fai clic su *Add source*. Viene visualizzato un messaggio che vi chiederà di inserire un URL. Fornisci l'URL del file CSV che hai pubblicato sul web, nella sezione precedente della guida e fai clic su *Create*. Vedrai una finestra di testo blu che indica l’elaborazione dati di OpenSpending. + +image_2 + +Clicca su *Refresh *o semplicemente usa il pulsante di aggiornamento del browser. Se OpenSpending riesce ad analizzare i dati, si dovrebbe vedere una casella di testo verde che indica che i dati sono pronti. Si dovrebbe anche vedere un elenco delle colonne del file CSV. + +image_3 + +Si noti che se si fornisce ad OpenSpending un file HTML invece di un file CSV valido, il software non si lamenterà, ma semplicemente cercherà di analizzare il codice HTML come se fosse un file CSV. Il risultato è simile al seguente. + +image_4 + +Se hai aggiunto una fonte dati non corretta, non ti preoccupare. Non è necessario utilizzare la fonte nel dataset finale: OpenSpending richiede di lavorare molto su una fonte di dati prima di poter essere pubblicata. Basta aggiungere una nuova, corretta sorgente e dimenticare quello sbagliata. + +**Prossimo** [Modellare i tuoi dati su OpenSpending] + +**Precedente** [Pubblicare i dati sul web] diff --git a/examples/openspending/content/help/guide/it/formattare-i-dati/index.md b/examples/openspending/content/help/guide/it/formattare-i-dati/index.md new file mode 100644 index 00000000..aa6ff2c4 --- /dev/null +++ b/examples/openspending/content/help/guide/it/formattare-i-dati/index.md @@ -0,0 +1,52 @@ +--- +section: help +lead: true +title: Formattare i dati +authors: +- stefanobandera +--- +Openspending si aspetta che tutti i dati sian presentati in un formato semplice. + +**CSV** + +OpenSpending accetta dati in un formato di file singolo, il Comma Separated Value (CSV​​). CSV è un file di testo che rappresenta i dati in forma di tabella, simile a un foglio di calcolo. In una tabella, ciascun dato è rappresentato da una riga, e le proprietà di ciascun dato sono rappresentate da una colonna. I file CSV codificano le tabelle dando ad ogni riga una linea nel file di testo e separando le colonne tramite virgole. + +I CSV accettati da OpenSpending sono denormalizzati, il che significa che essi non liberano spazio eliminando i valori ridondanti. Inoltre file CSV di OpenSpending sono a forma rettangolare, ovvero posseggono esattamente lo stesso numero di colonne in ogni riga. + +**Il format OpenSpending** + +I file CSV di OpenSpending devo avere le seguenti proprietà. + +1. Una riga di intestazione. La prima riga del file CSV deve contenere i nomi delle colonne, separati da virgole. Tutte le altre righe vengono trattate come righe dei dati. + +2. Almeno tre colonne. Valori indispensabili delle colonne sono: un importo, la data (in cui ci si potrebbe riferire solo all’anno), e un compratore o un destinatario (che potrebbe essere il nome di un account). + +3. Colonne corrispondenti. Ogni colonna deve rappresentare sempre un singolo tipo di valore per tutte le righe. (Non ci può essere nessuna riga sottointestata, per esempio.) + +4. Le righe sono punti dati. Le righe devono contenere un solo tipo di informazione: una transazione o una linea di bilancio. Una riga deve rappresentare al massimo un solo periodo di tempo. (Le righe non possono rappresentare più transazioni.) + +5. Nessun riga o cella vuota. Ogni riga di un file di dati importato deve contenere tutte le informazioni necessarie per costruire l'oggetto risultante. + +6. Nessun totale pre-aggregato (per es. totali parziali o "roll-up"). OpenSpending calcolerà questi automaticamente. + +7. Un identificatore unico. Ci deve essere una colonna (o una combinazione di colonne) il cui valore identifica in modo univoco ogni riga. Il modo più semplice per creare un tale identificativo è quello di aggiungere una colonna fittizia al dataset in cui si inserisce un numero che per ciascuna riga aumenta. È possibile farlo in Excel digitando i numeri nelle prime due file, selezionando entrambe le celle e trascinando verso il basso l'angolo inferiore destro della cella per estendere la serie. Se l'insieme dei dati ha troppe righe per Excel, è possibile aggiungere la colonna di identificazione unica usando [mySQL](http://stackoverflow.com/questions/16113570/how-to-add-new-column-to-mysql-table). + +8. Le date nel formato corretto. Le date devono essere nel formato "aaaa-mm-gg". + +9. I numeri nel formato corretto. I numeri devono contenere solo cifre e un periodo opzionale - no virgole! (Numeri leggibili come "12,345.67" devono essere convertiti in numeri come "12.345,67".) + +La comunità di OpenSpending ha raccolto qualche esempio di fogli di calcolo, al fine di illustrare come appaiono "buoni"o “cattivi” dati tabulari. + +Qui sono presentati esempi di cattiva formattazione dei fogli di calcolo: + +* [transazioni multiple su una riga](https://docs.google.com/spreadsheet/ccc?key=0AvdkMlz2NopEdG5kR0kzQ0E5V3BuTS16MndBT3dMdEE#gid=0), (diversi anni su di una stessa riga) + +* [cattivi numeri](https://docs.google.com/spreadsheet/ccc?key=0AvdkMlz2NopEdEo1Y2p2R0VvdnJvRXMwUVREbHRoLXc#gid=0), (i numeri hanno le virgole per leggibilità) + +* [Washington, DC](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdDhrZnRkWl9ZX2ZZNVptTzdueWw3emc#gid=0) (dati sulle transazioni) + +* [Minsk, Belarus](https://docs.google.com/a/okfn.org/spreadsheet/ccc?key=0AvdkMlz2NopEdEtIMFlEVDZXOWdDUEthUTQ0c21aV2c#gid=0) (dati sui bilanci) + +**Prossimo** [Pubblicare i dati sul web] + +**Precedente** [Raccolta Dati] diff --git a/examples/openspending/content/help/guide/it/index.md b/examples/openspending/content/help/guide/it/index.md new file mode 100644 index 00000000..ea01d7cf --- /dev/null +++ b/examples/openspending/content/help/guide/it/index.md @@ -0,0 +1,36 @@ +--- +section: help +lead: true +title: Guida ad OpenSpending +authors: +- stefanobandera +--- +La guida ad OpenSpending è un manuale che copre l'intero processo di scoperta, raccolta e uso dai dati sulla piattaforma OpenSpending. + +Introduzione + + +Aggiungere dati su OpenSpending + + +Visualizzazioni + + + +**Inizio** [Cos'è OpenSpending?] + +**Up** [ Altre guide] diff --git a/examples/openspending/content/help/guide/it/inserisci-una-visualizzazione-nel-tuo-sito-web/index.md b/examples/openspending/content/help/guide/it/inserisci-una-visualizzazione-nel-tuo-sito-web/index.md new file mode 100644 index 00000000..591585f6 --- /dev/null +++ b/examples/openspending/content/help/guide/it/inserisci-una-visualizzazione-nel-tuo-sito-web/index.md @@ -0,0 +1,56 @@ +--- +section: help +lead: true +title: Inserisci una visualizzazione nel tuo sito web +authors: +- stefanobandera +--- +Si può facilmente incorporare sul proprio sito web una delle visualizzazioni create su OpenSpending. Questo significa che puoi avere i display interattivi anche sul tuo sito. + +Presupponiamo che abbiate scelto una visualizzazione su Open Spending. Se noti sulla parte in basso a destra della pagina c'è un pulsante *Embed*. Fai clic su questo pulsante e ti verrà presentato il codice per incorporare la visualizzazione sul vostro sito web e alcune opzioni per le dimensioni (in pixel) . Per il resto bisogna solo tagliare e incollare questo codice nel tuo sito. Se non siete sicuri su come incollare correttamente il codice, contattare l'amministratore del sito. + +Il motivo per cui è possibile incorporare un codice dipende dai widget. In termini molto semplificati, un widget è un pezzo di codice che è possibile aggiungere alla tua pagina web, e tira i dati - in questo caso, dal database di OpenSpending - in modo che non sia necessario memorizzare i dataset per proprio conto. + +**Siti Satelliti** + +## INESC - Orçamento ao seu Alcançe (Budget alla tua portata?) + +Questa è stata una collaborazione tra OKF Brasil _ INESC (Istituto di studi socio-economici), una ONG brasiliano. L'obiettivo era quello di rendere più facile per il pubblico monitorare il bilancio federale brasiliano, e come è suddiviso tra i molti enti pubblici, con una particolare attenzione sui capitoli di spesa. + +I dati provengono da SIGA Brasil, un aggregatore dei tanti sistemi utilizzati dal governo per organizzare il bilancio. Questo ci permette di scegliere le colonne che vogliamo, ad esempio ente pubblico, categoria, sottocategoria, budget, spese, ecc, _ esportare in un file CSV. dati dal 2001, fino alla data attuale, aggiornato quotidianamente. A parte alcuni problemi, come le righe con mese "00", non abbiamo dovuto modificare molto per caricarlo in OpenSpending. + +### Costruire il sito + +Sapevamo di volerci concentrare su OpenSpending, cosa che ora avviene a vari livelli per tutti gli enti pubblici. Nel 2012, per esempio, il Ministero dell'Istruzione non ha speso il 16,3% del proprio bilancio (circa 6,1 miliardi di dollari). OpenSpending non aveva un grafico, out-of-the-box, che andrebbe bene per questo tipo di dati. Così abbiamo progettato il nostro software. + +Dopo alcune ore di prove, abbiamo deciso di fare un grafico a serie cronologica, con barre e linee. Il grafico in figura X mostra i dati del 2012 del Ministero dell'educazione . L'area blu rappresenta il budget (nota che cambia nel corso dell'anno). Le barre mostrano quanto è stato speso in quel determinato mese, e la linea mostra il totale delle spese fino ad ora. Si può vedere, dalla distanza della linea rossa dalla punta dell'area blu, che a Dicembre è stato alquanto sotto utilizzato. + +image_20 + +Per costruire questo grafico, stiamo usando NVD3, una libreria JavaScript con una raccolta di grafici riutilizzabili in D3. Il dato proviene da OpenSpending, utilizzando le API Aggregate. E 'ottimo e, dopo aver fatto un aggregazione, il risultato si memorizza nella cache e il programma diventa molto veloce. Ma esiste una limitazione che ci ha dato alcuni problemi: è possibile utilizzare solo una misura alla volta. + +Per questo grafico, abbiamo 2 misure: il budget ed i pagamenti. Ma, internamente, i pagamenti sono divisi in due parti: quello che è stato pagato per l'anno in corso, ed i debiti pagati negli anni precedenti. Così, ci troviamo con 3 misure. Visto che l'API Aggregata ne consente solo una, abbiamo dovuto fare tre richieste per la costruzione di questo grafico. + +Questo, ovviamente, crea un problema di prestazioni, sia per il nostro progetto sia per OpenSpending stesso. Ma, visto che le richieste vengono memorizzate nella cache dopo il primo utilizzo, si finisce per risolvere tutto. Esistono già piani per supportare più misure nelle API, quindi anche questo problema verrà risolto. + +### Per usare il Treemap + +Nella pagina di indice, abbiamo voluto mostrare una visione ampia del il bilancio riguardante gli enti pubblici. Inoltre, abbiamo voluto mostrare la quantità di denaro che viene utilizzato sia per funzione che per sottofunzione, come l’istruzione generale e l'istruzione di base. Per dimostrare questo, abbiamo scelto il Treemap. + +Tramite un widget è stato facile: basta crearlo in OpenSpending, prendere il codice e incollarlo nel sito. Ma abbiamo però incontrato alcune limitazioni. + +I widget sono fatti per quando si vuole semplicemente mettere il grafico in un post sul blog o articolo di giornale. Non è possibile personalizzarlo. Abbiamo dovuto cambiare i caratteri e i colori, per farlo entrare all'interno del design del resto della pagina. Dato che è un iframe, non c'è modo di cambiarlo usando solo CSS. Ma c'è una soluzione semplice: copiare il codice iframe del widget nella tua pagina. + +image_21 + +Non c'è bisogno di costruire un treemap, bastano poche righe di codice di inizializzazione. Quando è nella tua pagina, è possibile utilizzare anche CSS. Purtroppo, questo non funziona per tutto: i colori non possono essere modificati in questo modo. Ma è facile configurare un altro schema di colori: devi semplicemente cambiare il codice di inizializzazione. Abbiamo anche aggiunto un pulsante "Indietro", in modo da poter navigare facilmente tra funzioni e sottofunzioni. + +**Searching** + +Per aiutare l'utente a trovare gli enti pubblici, abbiamo implementato un motore di ricerca con il completamento automatico, utilizzando il plug-in di Twitter Bootstrap typeahead. Poiché non ci sono molte entità (circa 500), abbiamo deciso di caricarle tutte quando l'utente entra prima nella pagina, in modo che la ricerca sia istantanea. + +image_22 + +**Precedente** [Crea una visualizzazione] + +**Inizio** [Guida ad OpenSpending] diff --git a/examples/openspending/content/help/guide/it/modellare-i-tuoi-dati-su-openspending/index.md b/examples/openspending/content/help/guide/it/modellare-i-tuoi-dati-su-openspending/index.md new file mode 100644 index 00000000..bd1b8d67 --- /dev/null +++ b/examples/openspending/content/help/guide/it/modellare-i-tuoi-dati-su-openspending/index.md @@ -0,0 +1,76 @@ +--- +section: help +lead: true +title: Modellare i tuoi dati su OpenSpending +authors: +- stefanobandera +--- +Per caricare i dati in OpenSpending, è necessario costruire un modello - dati. Un modello serve a specificare come i dati si traducano in termini che OpenSpending comprenda. OpenSpending rappresenta le proprietà dei dati in termini di dimensioni. I dati di modello si realizzano elencando le dimensioni che si desidera studiare nel dataset caricato su OpenSpending, e specificando come questi si relazionino alle colonne presenti nei dati di origine. + +### Dimensioni obbligatorie: quantità e tempo + +Ogni modello deve avere almeno due dimensioni: una quantità e un tempo. Questi specificano la dimensione della transazione e il momento in cui questa è avvenuta. La quantità e il tempo sono associati a particolari tipi di dimensioni. L'importo viene rappresentato da una misura, e il tempo è rappresentato da una data. Dimensioni generiche non possono rappresentare questi valori specifici. + +Quando modelli i dati, non è una cattiva idea quella di iniziare con le dimensioni obbligatorie. Per iniziare, fai clic su *Dimensions & Measures* all'interno della pagina **Manage the dataset**. + +image_5 + +Successivamente, fai clic su *Add Dimension *per aprire il nuovo pannello *Add new dimension*. Clicca sul pulsante *Date*. Vedrai la casella *Name box *riempirsi automaticamente con il "tempo", come mostrato di seguito. Fai clic sul pulsante verde Aggiungi (**Add**). + +image_6 + +La prossima schermata fornirà alcune informazioni sul significato del tempo. Nella casella a discesa accanto alla Colonna, seleziona la colonna dei dati che rappresenta il valore del tempo. + +image_7 + +Dopo aver identificato la colonna tempo, fai clic su *Add Dimension *per aggiungere la dimensione quantità. Questa volta, selezionare il pulsante di opzione *Misura*, che riempirà automaticamente la colonna "amount", e clicca su *Add*. Scegli la colonna che rappresenta il valore della transazione tramite il box a discesa accanto alla Colonna. + +### Le dimensioni chiavi e di compound + +Soltanto una dimensione supplementare è necessaria per rendere il modello valido: la dimensione (o insieme di dimensioni) il cui valore identifica ciascun punto dei dati, la chiave. + +Un punto dati non deve essere identificato dal valore di una singola colonna. Esso può essere identificato dalla combinazione di varie colonne in una dimensione composta. Poiché le chiavi possono essere composte, il tipo di dimensione deve essere utilizzato per rappresentarle, anche se la chiave particolare non è composta. + +Per aggiungere la dimensione chiave, clicca su ** *Add Dimension * **e seleziona il pulsante *Dimension*. Inserisci un nome per la chiave, come "key", nel *Name box*. Fai clic su ** *Add* **. Selezionare la casella *include _ unique key *per identificare questa dimensione come parte della vostra chiave. + +Successivamente, date un'occhiata alla **Field list**, che contiene due file *name *e *label*. Una dimensione composta può contenere un numero arbitrario di campi, ciascuno dei quali ha un nome e una tipizzazione e ciascuno dei quali può essere associato a una colonna nei dati. Questo è il senso per cui tali dimensioni sono dette "composte": esse raggruppano colonne multiple derivanti dai dati di origine, in una singola proprietà del dataset di destinazione. + +image_8 + +Una dimensione composta richiede almeno due campi, *name* e *label*, che devono essere rispettivamente di tipo id e di stringa. Il nome della dimensione viene utilizzato per dotarla di un URL funzionante, l'etichetta viene utilizzata per presentarla nell'interfaccia utente. + +Per creare una dimensione composta minima, è sufficiente associare la stessa colonna dei dati di origine con nome ed etichetta. Scegliere la colonna appropriata per ciascuna dimensione e lasciare le tipologie predefiniti invariati. + +### Misure e altre dimensioni + +Con quantità, tempo e chiave, il modello è sufficientemente ricco. Un modello veramente completo, tuttavia, comprenderà dimensioni per ogni proprietà significativa dei dati di origine. Seguendo alcune convenzioni questo diventa più conveniente. + +Un modello comune per i dati di origine sta diffondendo informazioni che identificano entità - gruppi, account, e così via - tramite diverse colonne. Le informazioni su un account associato a una transazione ad esempio possono essere visualizzate dividendo in una colonna "Account", con un numero di identificazione e una colonna "descrizione Account" con una descrizione verbale. "Head-account" e "Sub-account" nell'immagine qui di seguito presentano questo modello. + +image_9 + +Le dimensioni composte di OpenSpending sono progettate per modellare questo tipo di informazioni sparse. Per farlo, aggiungi una nuova dimensione composta e associa ogni colonna ad uno dei campi della dimensione creata. Cerca di far corrispondere una colonna leggibile e una colonna più concisa per essere rinominata. Nell'immagine sottostante, "Head-account" è abbinato a *name* e " Head-account description" a *label*. + +image_10 + +Alcune colonne di dati sono più autonome, rappresentando particolari attributi di ciascun punto dati. Una colonna che ordina ogni transazione in qualche categoria, per esempio, è di questo tipo. Nell'immagine sottostante le colonne Reporting Type, Revenue/Expenditure, e Recurrent/Investment sono di questo tipo. + +image_11 + +Colonne indipendenti che specificano attributi o categorie sono meglio modellate con le dimensioni *attribute*. Un attributo è essenzialmente una dimensione con un solo campo, che può essere di qualsiasi tipo. Per creare un attributo, è sufficiente selezionare il pulsante di opzione *Attribute* quando si aggiunge una dimensione. + +image_12 + +**Concludendo: salvataggio e caricamento** + +Quando ogni dimensioni è stato impostata e collegata alle rispettive colonne nei dati di origine, fai clic su *Save Dimensions* per salvare il modello. Se qualcosa è sbagliato con il modello, viene visualizzato un messaggio di errore che richiede di correggere i parametri. In caso contrario, verrà visualizzato un messaggio che ti invita a tornare alla dashboard, dove si può procedere a caricare i dati. + +Una volta che i dati sono stati caricati, il modello creato sarà fisso e il montaggio sarà disattivato. Quindi,volendo, si può testare il modello prima di caricarlo. Per fare questo, clicca su Test nella riga dedicata alla fonte dati presente nella dashboard. Attendi alcuni secondi, quindi ricarica la pagina. Se viene visualizzato un messaggio con uno sfondo verde che dice COMPLETE, il modello è pronto a partire. Se vedi errori, sono necessarie alcune riparazioni. + +image_13 + +Se il vostro modello è privo di errori, fai clic su *Load* per caricare il dataset di origine e applicare il modello. Si può quindi tornare alla home page del dataset cliccando sul suo nome nella parte superiore della schermata, in cui è possibile procedere alla costruzione di effetti grafici e giocare con i vostri dati. + +**Prossimo** [Crea una visualizzazione] + +**Precedente** [Creare un dataset su OpenSpending] diff --git a/examples/openspending/content/help/guide/it/pubblicare-i-dati-sul-web/index.md b/examples/openspending/content/help/guide/it/pubblicare-i-dati-sul-web/index.md new file mode 100644 index 00000000..40f36b1d --- /dev/null +++ b/examples/openspending/content/help/guide/it/pubblicare-i-dati-sul-web/index.md @@ -0,0 +1,38 @@ +--- +section: help +lead: true +title: Pubblicare i dati sul web +authors: +- stefanobandera +--- +I dati non possono (ancora) essere caricati direttamente su OpenSpending. Per essere aggiunti al database OpenSpending, i dati devono prima essere resi accessibili dal web. Questa sezione presenta due modi convenienti per pubblicare il dataset on-line. + +**Google Drive** + +È possibile rendere i dati accessibili sul web, trasformandoli in un foglio di calcolo di Google Drive. + +1. Importa i tuoi dati. Crea un nuovo foglio di calcolo di Google Drive, quindi seleziona Import ... dal menu File. Selezionare *Replace Spreadsheet*, fai clic su **Choose file**, e sposta il file CSV. + +2. Assicurati che Google Docs non sfalsi le date dei vostri dati. Seleziona la colonna che contiene le date. Fai clic sul menu *Format* e selezionare *Number* -> *More formats *-> 2008-09-26. I dati dovrebbero apparire nel formato **aaaa-mm-gg **. + +3. Fai clic sul menu File e seleziona *Publish to the web *.... Nella finestra che appare, clic sul pulsante ** *Start publishing* **. Sotto *get a link to the published data , select *** *CSV* *** *(comma separated values). + +image_0 + +L’URL in fondo al box ora si riferisce ai tuoi dati. + +**Gist** + +GitHub Gist è un modo conveniente per ospitare piccole quantità di testo, inclusi i file CSV. + +1. Fai log-in su GitHub (o registrati se non l'hai già fatto), quindi naviga su [gist.github.com](https://gist.github.com/). + +2. Fai clic e trascina il file CSV dal file manager del tuo sistema operativo alla pagina di Sintesi *GitHub *del tuo browser. Verranno visualizzati il nome e il contenuto del file. + +3. Fare clic su Create Public Gist per essere trasportati nella homepage del vostro nuovo Gist. L'URL relativo ai tuoi dati è accessibile attraverso il pulsante "angle brackets (parentesi angolari)" nell'angolo in alto a destra del file. + +image_1 + +**Prossimo** [Creare un dataset su OpenSpending] + +**Precedente** [Formattare i dati] diff --git a/examples/openspending/content/help/guide/it/quali-tipi-di-dati-finanziari-entrano-in-openspending/index.md b/examples/openspending/content/help/guide/it/quali-tipi-di-dati-finanziari-entrano-in-openspending/index.md new file mode 100644 index 00000000..5b11cb7e --- /dev/null +++ b/examples/openspending/content/help/guide/it/quali-tipi-di-dati-finanziari-entrano-in-openspending/index.md @@ -0,0 +1,48 @@ +--- +section: help +lead: true +title: Quali tipi di dati finanziari entrano in OpenSpending? +authors: +- stefanobandera +--- +OpenSpending è molto flessibile nel tipo di dati finanziari che supporta. Anche se il progetto OpenSpending ha un forte focus sulla finanza pubblica, questo non è un vincolo tecnico. OpenSpending supporta qualsiasi insieme di dati costituito da un insieme di transazioni, ciascuna associata ad una quantità di denaro e un periodo di tempo. + +La maggior parte dei dati attualmente ospitati su OpenSpending possono essere classificati come dati transazionali o di bilancio. La differenza principale tra questi è il loro livello di granularità. Dati transazionali o di transazione tracciano singole operazioni, mentre i dati sul bilancio aggregano le transazioni in categorie. + +### Dati di spesa derivanti da transazioni + +I dati di transazione, o semplicemente "i dati di spesa", tracciano singole operazioni finanziarie. Ogni pagamento tra singoli soggetti, in una determinata data, e per uno scopo specifico (ad esempio, un progetto o un servizio) è elencato singolarmente. Dati di spesa transazionali comprendono vari tipi di record, comprese le informazioni sui contributi pubblici, le obbligazioni, e le spese effettive. + +Le informazioni aggregate (ad esempio la somma) non dovrebbero essere incluse nei dati di transazione. Dati che sono stati parzialmente o completamente aggregati richiedono una diversa modalità di analisi e devono essere trattati come dati di bilancio piuttosto che dati di transazione. Ciò non significa, tuttavia, che i diversi pagamenti "fisici", che si riferiscono ad una singola transazione "logica" non possano essere rappresentati da una singola operazione nella tipologia dei dati transazionali. + +I dati di transazione in OpenSpending includono: + +* [DC Venditori e Contraenti](http://openspending.org/dc-vendors-contractors) + +* [L’Austrian Development Agency](http://openspending.org/ada) + +Un altro tipo correlato di dati si riferisce alle procedure di aggiudicazione degli appalti pubblici. Dati sugli appalti sono dati relativi a gare pubbliche: quanto è stato offerto, per quanto, e chi ha vinto la gara. Esso può essere visto come un sottoinsieme dei dati di transazione. + +I dati sugli appalti comprendono: + +* [Marchés publics au Sénégal](http://openspending.org/marches-publics-senegal/views/liste-des-attributaires) + +* [Marchés publics France 2011](http://openspending.org/marches-publics-france-2011) + +### Dati di bilancio + +Nei dati di bilancio, le spese e i redditi sono aggregati per categorie. L'obiettivo di questa aggregazione è quello di aiutare il lettore nella comprensione del bilancio, che in genere è un documento di policy che viene utilizzato per fornire una panoramica sulle più importanti scelte finanziarie del governo. L'allocazione dei dati è tipicamente strutturata da uno schema di classificazione, piuttosto che tramite i destinatari effettivi dei fondi. + +I dati di bilancio spesso presentano congiuntamente dati sui risultati del passato e sugli stanziamenti per un periodo futuro. In una tale presentazione, gli importi spesi negli anni precedenti su un particolare settore, sono utilizzati per informare su quanto dovrebbe essere assegnato per il prossimo periodo di programmazione finanziaria. Le informazioni di bilancio spesso si basano su stime e dati aggregati. + +Diverse regioni riportano differenti tipi di informazioni di bilancio disponibili, tra cui: Dichiarazioni Pre-Budget, proposte di bilancio esecutivo, bilanci promulgati, e fondi stanziati per i cittadini (versioni semplificate di quote di bilancio a beneficio dei cittadini). + +I dati di bilancio su OpenSpending includono: + +* [Berlin Budget](http://openspending.org/berlin_de) + +* [Seville Spending Budget](http://openspending.org/seville-budget) + +**Prossimo** [Come vengono rappresentati i dati su OpenSpending?] + +**Precedente** [Cos'è OpenSpending] diff --git a/examples/openspending/content/help/guide/it/raccolta-dati/index.md b/examples/openspending/content/help/guide/it/raccolta-dati/index.md new file mode 100644 index 00000000..ccfa8d7e --- /dev/null +++ b/examples/openspending/content/help/guide/it/raccolta-dati/index.md @@ -0,0 +1,16 @@ +--- +section: help +lead: true +title: Raccolta Dati +authors: +- stefanobandera +--- +Per aggiungere un dataset ad OpenSpending, è necessario disporre di alcuni dati. Se già li avete, si può procedere. In caso contrario, è necessario trovarli. + +Inizia la tua ricerca dati consultando alcune risorse, come la [School of Data](http://schoolofdata.org/handbook/courses/finding-data/) e il [Data Journalism Handbook](http://datajournalismhandbook.org/1.0/en/getting_data.html). È inoltre possibile ottenere alcune idee su come strutturare la ricerca visitando l’ [OpenSpending group](http://datahub.io/group/openspending) su datahub.io, e porre domande sul canale IRC # openspending su Freenode. + +I dati che troverete, si spera siano in un formato "leggibile", per esempio sotto forma di un foglio di calcolo di Excel o in un file CSV. Se trovate i dati in un formato come PDF o un documento Word, questo sarà molto difficile da lavorare, e si potrebbe considerare semplicemente di cercare dati diversi! + +**Prossimo** [Formattare i dati] + +**Precedente** [Aggiungere dati ad OpenSpending] diff --git a/examples/openspending/content/help/guide/npl/index.md b/examples/openspending/content/help/guide/npl/index.md new file mode 100644 index 00000000..9f597541 --- /dev/null +++ b/examples/openspending/content/help/guide/npl/index.md @@ -0,0 +1,23 @@ +--- +section: help +lead: true +title: "\uFEFFओपन स्पेनडिंग मार्गदर्शन" +authors: +- Prakash Neupane +--- +ओपन स्पेनडिंग मार्गदर्शन भनेको ओपन स्पेनडिंगको गाईड हो, जसले विस्त्रत रुपमा ओपन स्पेनडिंगमा डाटा पत्ता लगाउने, त्यसलाई जोड्ने र प्रयोग गर्ने सम्पुर्ण तरिका ओगट्छ । + +* परिचय +* [ओपन स्पेनडिंग भनेको के हो ?](npl/ओपन-स्पेनडिंग-भनेको-के-हो/) +* [ओपन स्पेनडिंग कुन कुन प्रकारका अर्थिक तथ्यांक परछन् ?](npl/ओपन-स्पेनडिंग-कुन-कुन-प्र/) +* [ओपेन स्पेनडिंगले तथ्यांक कसरी प्रस्तुत गर्छ ?](npl/ओपेन-स्पेनडिंगले-तथ्यांक/) +* ओपेन स्पेनडिंगमा तथ्यांक थप्ने +* [समिक्षा](npl/ओपेन-स्पेनडिंगमा-तथ्यांक/) +* [तथ्यांक संकलन गरिदै] +* [तथ्यांक ढाँचा मिलाइदै] +* [तथ्यांकलाई वेबमा प्रकाशन गरिंदै] +* [ओपेन स्पेनडिंगमा तथ्यांक पात्र(डाटा सेट) निर्माण गरिदै ] +* [तपाइको तथ्यांकलाई ओपन स्पेनडिंग चित्रण (मोडलिङ) गर्ने] +* [दृश्याङ्कन (भिज्जोलाईजेसन)] +* [दृश्याङ्कन निर्माण] +* [आफ्नो वेबसाइटमा दृश्याङ्कन समाहित गराउनुहोस्] diff --git a/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-कुन-कुन-प्र/index.md b/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-कुन-कुन-प्र/index.md new file mode 100644 index 00000000..a005c461 --- /dev/null +++ b/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-कुन-कुन-प्र/index.md @@ -0,0 +1,43 @@ +--- +section: help +lead: true +title: ओपन स्पेनडिंग कुन कुन प्रकारका अर्थिक तथ्यांक परछन् ? +authors: +- Prakash Neupane +--- +ओपनस्पेन्डिङ्ग यो समर्थन गर्छ कि फाइनेन्सीयल तथ्याङ्कको प्रकारमा एकदम लचीलो छ । ओपनस्पेन्डिङ्ग परियोजना सरकारो वित्तमा एकदम ध्यान केन्दित रहेको छ, यो एउटा विधिबाधाहरु हैन । ओपनस्पेन्डिङ्ग एउटा लेनदेनको सेट, पैसाको एक मात्रा को साथ जोडेको प्रत्येक र एक समयमा कुनै पनि डाटासेटको समर्थन गर्छ । + +वर्तमानमा ओपनस्पेन्डिङ्ग मा हेस्ट डाटाको अधिकांश व्यवहार या बजेटीय डाटाको रुपमा वर्गीकृत गर्न सक्छौ । यो दुई को बीच मुख्य अंतर यो हो कि विघटनको आफनो स्तर छ । व्यवहार डाटा बजेटीय डाटा लेनदेन जबपक श्रेणीमा, व्यक्तिगत लेनदेन मार्ग . + +####करोबार स्पेनडिंगमा तथ्यांक +व्यवहार डाटा, या सरल, “डाटा खर्च” व्यक्तिगत वित्तिय लेनदेन मार्ग । एउटा निश्चित तिथिमा र एक विशिष्ट प्रयोजन (एक परियोजना या सेवा उदाहरण को लागि) को लागि एउटा इकाईबाट दोश्रोमा प्रत्येक भुगतान छुटै सुचीमा छ । लेनदेन सम्बन्धी खर्च डाटा सरकारी अनुदान, प्रतिबद्धता, र वास्तविकव्ययको बारेमा जानकारी सहित अभिलेखको विभिन्न प्रकार, सामेल छ । + +सकल जानकारी (जस्तोः सबटोतल) व्यवहार डाटामा सामेल हुनु हुदैन । आंशिक रुपमा या पूरा तरीका ले विश्लेषणको एक अलग विद्याको लागि कल एकत्रित गरिएको छ कि डाटा बजेटीय डाटाको सत्ता व्यवहार डाटाको रुपमा व्यवहार गर्न सकियोस् । यो मतलब हैन की, तथापि, एउटा पनि “तर्कसंगत” लेन–देन को लागि राशि जो कि धेरै “भौतिक” भुगतान व्यवहार डाटामा एउटा एकलाबाट प्रतिनिधित्व गर्न सकिदैन । + +ओपनस्पेन्डिङ्गमा व्यवहार डाटा सामिल छः + +* [डी.सी. बिक्रेता र क्रेता](http://openspending.org/dc-vendors-contractors) +* [औस्त्रिअन बिकास संस्था](http://openspending.org/ada/) + +सरकारी खरिद प्रकियाको साथमा डाटा व्यापार को एक अन्य सम्बन्धि प्रकार । सार्वजनिक खरिद डाटा सार्वजनिक टेन्डर को बारेमा डाटा छ । प्रस्तुत गरिएको थियो कि, टेन्डर जित्यो कति, अरु जो को लागि । यो व्यवहार डाटा को एउटा सबसेटको रुपमा देख्न सक्छौ । + +ओपनस्पेन्डिङ्ग मा खरिद डाटा सामिल छः + +* [मार्चएस पब्लिकस औ सेनेगल](http://openspending.org/marches-publics-senegal/views/liste-des-attributaires) +* [मार्चएस पब्लिकस फ्रान्स २०११](http://openspending.org/marches-publics-france-2011) + +####आय ब्यय विवरण तथ्यांक +बजेटको डाटामा, व्यय र आय श्रेणीमा एकत्रित गरेर राखेको छ । यस एकत्रितकरणको लक्ष्य आमतरिकामा सरकारको सबभन्दा महत्वपूर्ण वित्तीय विकल्पको एक सिंहावलोकनको साथ पाठलाई प्रदान गरिएको छ कि एउटा नीति दस्तावेज हो जो बजेटलाई सम्झनेमा पाठकलाई सहायताको लागि हो । दरबन्दी आमतरिकामा एउटा बर्गीकरण योजनाको बजाय धनको वास्तविक प्राप्तकर्ता द्धारा संरचित छ । + +बजेटीय डाटा धेरैजसो संयुक्त रुपमा एक भविष्यको अवधिको लागि पछिल्लो परिणाम र विनायोजनमा डाटा प्रस्तुत गरेको छ । यस्तो प्रकारको एक प्रस्तुतिमा, एक विशेष क्षेत्रमा पछिल्लो वर्षमा खर्च मात्रामा आइरहेको बजेटको अवधिको लागि बाँडफाँड गर्न पर्छ कति सूचना गर्नको लागि उपयोग गर्न पर्छ । बजेट जानकारी धेरैजसो एकत्रित डाटा र सांख्यिकीय अनुमानमा आधारित छ । + +कार्यकारी बजेट प्रस्ताव, अधिनियमित बजेट, र नागरिक बजेट (नागरिकहरुको लाभको लागि बजेटको सरल संस्करण) को पूर्व बजेट विवरणः विभिन्न क्षेत्र सहित उपलब्ध बजेटीय जानकारी, को विभिन्न प्रकार छ । + +ओपेन स्पेन्दिङमा पर्ने आर्थिक तथ्याङ्क: + +* [बेर्लिन बजेट](http://openspending.org/berlin_de) +* [सेविल्ले स्पेनडिंग बजेट](http://openspending.org/seville-budget) + +**अर्को**: [ओपेन स्पेनडिंगले तथ्यांक कसरी प्रस्तुत गर्छ ?] + +**माथी**: [ओपन स्पेनडिंग मार्गदर्शन](../) diff --git a/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-भनेको-के-हो/index.md b/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-भनेको-के-हो/index.md new file mode 100644 index 00000000..adf1e2f1 --- /dev/null +++ b/examples/openspending/content/help/guide/npl/ओपन-स्पेनडिंग-भनेको-के-हो/index.md @@ -0,0 +1,14 @@ +--- +section: help +lead: true +title: ओपन स्पेनडिंग भनेको के हो +authors: +- Prakash Neupane +--- +ओपनस्पेन्डिङ एउटा तथ्याङ्क भाग लगाउने समुदाय तथा वेब एपलिकेशन जस्ले सरकारी तथा सहकारी आर्थिक कारोवारको मार्ग संसार भरि भएको तथ्याङ्कलाई उपयोग तरिकामा हाल्ने हो । ओपनस्पेन्डिङ एउटा खुल्ला योजना हो जुन अंशदाता समुदायबाट चालु भइरहेको छ । रुचिभएका जो सुकै अंशदाताले यस खर्च तथ्याङ्कमा ओपनस्पेन्डिङ सफटवेयर र ओपनस्पेन्डिङ एपिआई प्रयोग गरेर ओपनस्पेन्डिङ डाटावेश, चाक्षुषीकरण गनृ सकनुहुन्छ । + +यस खण्डले नयाँ ओपनस्पेन्डिङ अंशदातालाई सिस्तमको अन्तरंग विचारलायृ परिचय गराउछ । यसले फाइनेन्सियल तथ्याङ्कका प्रकार जसले ओपनस्पेन्डिङ थाम्ने, र यसले कसरी ओपनस्पेन्डिङ तथ्याङ्कलाई वर्णन गर्छ । + +**अर्को**: [ओपन स्पेनडिंग कुन कुन प्रकारका अर्थिक तथ्यांक परछन् ?](../ओपन-स्पेनडिंग-कुन-कुन-प्र/) + +**माथी**: [ओपन स्पेनडिंग मार्गदर्शन](../) diff --git a/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगमा-तथ्यांक/index.md b/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगमा-तथ्यांक/index.md new file mode 100644 index 00000000..ce95042a --- /dev/null +++ b/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगमा-तथ्यांक/index.md @@ -0,0 +1,26 @@ +--- +section: help +lead: true +title: 'ओपेन स्पेनडिंगमा तथ्यांक थप्ने : समिक्षा]' +authors: +- Prakash Neupane +--- +तपाई ओपनस्पेन्डिङ्ग परियोजनाको लागि सब भन्दा महत्वपूर्ण योगानको लागि एउटा नयाँ डाटासेट जोड्नको लागि हो । गाइडको यो खण्ड नयाँ डाटा जोड्ने प्रकियाको माध्यमबाछ चल्द छ । + +ओपनस्पेन्डिङ्गमा एउटा डाटासेट आयात गर्नको लागि एउटा विशिष्ट कार्यप्रवाह निम्नलिखित चरण शामिल छ । + +* भर्पर्दो श्रोत बाट मेशिनले पढ्नयोग्य तथ्याङ्क संकलन गर्नुहोस् + +* विसंगति र त्रुटिलाई हटाउनको लागि या स्पष्ट, ओपनस्पेन्डिङ्गबाट आशाको ढाँचाको एउटा सीएसवी फाइल बनाउनको लागि डाटा परिवर्तित । + +* तथ्याङ्क लाई ईन्टरनेट मा प्रकाशित गर्नुहोस् एउटा डाटासेट एउटा नयाँ डाटा स्रोतको रुपमा प्रकाशित डाटा जोड्न बनाउने । + +* स्रोत तालिकामा प्रत्येक स्तंभको लागि एक तार्किक भूमिका आवंटित गर्नको लागि डाटासिट मोडल । + +* डाटा लोड अथवा डाटाको स्थिरताको बारेमा मंचद्धारा दिइएको फीडबैकको आधारमा डाटाको परिष्कृत + +यो कदमबाट प्रत्येक निम्न वर्गमा विस्तारमा व्याख्या गरिनेछ । + +**अर्को**: [तथ्यांक संकलन गरिदै] + +**माथि**: [ओपन स्पेनडिंग मार्गदर्शनहरु](../) diff --git a/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगले-तथ्यांक/index.md b/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगले-तथ्यांक/index.md new file mode 100644 index 00000000..ffe48cd9 --- /dev/null +++ b/examples/openspending/content/help/guide/npl/ओपेन-स्पेनडिंगले-तथ्यांक/index.md @@ -0,0 +1,25 @@ +--- +section: help +lead: true +title: ओपेन स्पेनडिंगले तथ्यांक कसरी प्रस्तुत गर्छ ? +authors: +- Prakash Neupane +--- +एउटा अलग स्रोत बाट डाटाको एक सेट को प्रतिनिधित्व गर्दछ, जसमा प्रत्येक ओपनस्पेन्डिङ्ग डाटासेटलाई एउटा संग्रह गरेर राख्छ । प्रत्येक डाटासेन्टर भित्र, व्यक्तिगत लेनदेन टिपोड को एक सेट प्रतिनिधित्व गरिरहेको हुन्छ । प्रत्येक डाटासेट डाटा को संरचना नक्सा हुन्छ र आफ्नै मोडेल हुन्छ । मोडल आयामको सन्दर्भमा एउटा डाटासेट प्रविष्टको गुण लिपिमा हाल्नु । + +#### तथ्यांक पात्र (डाटासेट) +ओपनस्पेन्डिङ्ग प्रणालीमा भास्मिक इकाईको डाटासेट हुन्छ । एउटा सामान्य विषय (एउटा विशेष रुपमा शहरको खर्च, एक वर्ष को लागि एउटा बजेट जस्तै) बाड्नको वित्तिय लेनदेनको साथ सकुहीकृत र एउटा डाटासेटको रुपमा जम्मा हुनुजान्छ । एउटा डाटासेट “टिपोट” को एउटा संग्रह हो, र प्रत्येक प्रविष्टि पैसाको मात्रा र एक समयको साथ जोड्ने एउटा लेनदेनको प्रतिनिधित्व गर्छ । + +डाटासेट पनि आफ्नो सामग्री को प्रकारको लागि मेटाडाटालाई शामिल गर्छ । मेटाडाटा एउटा डाटासेटको विवरण, डाटाको स्रोतको बारेमा जानकारी हुन्छ, र उपयोगकर्ताको डाटासेट पाउछ र उसको सामग्रीका व्याख्याको मद्दत गर्छ जस्मा अन्य जानकारी पनि सामिल छ । + +#### प्रकार (मोडेल) +प्रत्येक डाटासेटको संरचना डाटासेटको निमौताको लागि पुरा तरिकामा निर्भर छ । यस संरचना टिपोटको आफुबिचमा अखग हुन सक्छ जस्को साथमा आयाम प्रदान गर्छ जो एक मोडेल, निर्दिष्ट द्धारा बनाईएको हो । + +एउटा मोडेलको आयामको एउटा सेट सामिल छ । एउटा आयाम संभवतः एक से एक टिपोट छुट्याउने एक सम्पत्ति हो । तपाई एउटा स्प्रेडशीटको रुपमा एउटा डाटासेटको कल्पना गर्दछ । त्यो प्रत्येक आयाम एउटा स्तंभको रुपमा सोच्न सक्छौ । आयाम त्यस्तैगरि, एउटा साधारण स्प्रेडशीट स्त्ंभ भन्दा अधिक संरचना बनाउन सक्छौ । + +आयाम धेरै प्रकारमा आउछ । सबै भन्दा महत्वपूर्ण परिमाण प्रकार हो । परिमाण एउटा संख्यात्मक मुल्य शामिल गर्न सक्छौ जो आयाम हो । एउटा अर्काे महत्वपूर्ण आयाम प्रकार मिति र समयको प्रतिनिधित्व गर्छ, जो समयको प्रकार हो । हरेक डाटाले यो ठाउँ लिन्छ जब क्रमशः लेन–देनको प्रतिनिधित्वले पैसाको राशि र समयको प्रतिनिधित्व गर्छ, कम से कम एउटा उपाय र समय आयाममा प्रत्येक जरुरी हुन्छ । +शेष आयाम प्रकार जस्तै, तब हुन सक्छ जबकी अन्य गुणहरुको प्रतिनिधित्व गर्नको लागि उपयोग गर्न सक्छौ लेनदेनको संख्या, एउटा वर्गीकरण योजना, यस यसमा सामेल व्यक्तिहरु या कम्पनिको नामबाट लेबल । यस प्रकारको आयाम मुल्यको एउटा नेस्टेड सेट समात्न सक्छौ जुन एउटै मुल्य पकडन सक्ने जुन गुण, अरु मिश्रित आयाम, समावेश छ । एउटा सम्पत्ति प्रत्येक कुल डाटा गर्नको लागि प्रयोग गर्न सक्दछौ जुनमा धेरै उप गुण समावेश हुन्छ जब यौगिक आयाम उपयोगी हुन्छ । + +**अर्को**: [ओपेन स्पेनडिंगमा तथ्यांक थप्ने] + +**माथी**: [ओपन स्पेनडिंग मार्गदर्शन](../) diff --git a/examples/openspending/content/help/guide/rom/index.md b/examples/openspending/content/help/guide/rom/index.md new file mode 100644 index 00000000..bba14d28 --- /dev/null +++ b/examples/openspending/content/help/guide/rom/index.md @@ -0,0 +1,10 @@ +--- +section: help +lead: true +title: Ghidul utilizatorului OpenSpending +authors: +- Anders Pedersen +--- +Ghidul utilizatorului OpenSpending (as a Google Doc). + +The guide needs to be reformatted and posted here (in markdown). You can help editing this guide page by getting in touch with the community here. diff --git a/examples/openspending/content/help/guide/tur/index.md b/examples/openspending/content/help/guide/tur/index.md new file mode 100644 index 00000000..a2362d58 --- /dev/null +++ b/examples/openspending/content/help/guide/tur/index.md @@ -0,0 +1,10 @@ +--- +section: help +lead: true +title: AçıkHarcama Rehberi - The OpenSpending guide in Turkish +authors: +- Anders Pedersen +--- +AçıkHarcama Rehberi - the OpenSpending guide is available in Turkish as a short version in this Google Doc. + +You can help translate the rest of the OpenSpending guide into Turkish by accessing the original English language version. diff --git a/examples/openspending/content/help/index.md b/examples/openspending/content/help/index.md index e712d3a2..a8de7849 100644 --- a/examples/openspending/content/help/index.md +++ b/examples/openspending/content/help/index.md @@ -11,12 +11,12 @@ of our guides and get rolling! If you have questions, The OpenSpending Guide is available in multiple languages: -* [English](./guide/en) -* [French](./guide/fr) -* [Italian](./guide/it) -* [Nepali](./guide/npl) -* [Romanian](./guide/rom) -* [Spanish](./guide/esp) +* [English](./help/guide/en) +* [French](./help/guide/fr) +* [Italian](./help/guide/it) +* [Nepali](./help/guide/npl) +* [Romanian](./help/guide/rom) +* [Spanish](./help/guide/esp) Many other translations are under development. Check back for new translations or diff --git a/examples/openspending/package-lock.json b/examples/openspending/package-lock.json index e862ac3c..497c7445 100644 --- a/examples/openspending/package-lock.json +++ b/examples/openspending/package-lock.json @@ -8,7 +8,6 @@ "name": "my-app", "version": "0.1.0", "dependencies": { - "@flowershow/markdowndb": "^0.1.8", "@githubocto/flat-ui": "^0.14.1", "@headlessui/react": "^1.7.14", "@heroicons/react": "^2.0.18", @@ -32,7 +31,7 @@ "eslint-config-next": "13.4.3", "flexsearch": "0.7.21", "isomorphic-unfetch": "^4.0.2", - "mddb": "^0.1.9", + "mddb": "0.2.1", "next": "13.4.3", "next-mdx-remote": "^4.4.1", "next-seo": "^6.0.0", @@ -1155,35 +1154,6 @@ "react-dom": ">=16.8.0" } }, - "node_modules/@flowershow/markdowndb": { - "version": "0.1.8", - "resolved": "https://registry.npmjs.org/@flowershow/markdowndb/-/markdowndb-0.1.8.tgz", - "integrity": "sha512-Vjb15Kwuce1P1nLrN3C/ULo+/2TZTKvjMKV0Y8PG8K48yKa2mbBj+Wk7hPt6Fe5enAvntpP70KRDcaiH6aWM2g==", - "deprecated": "This package has been renamed to `mddb`. Please use `mddb` instead.", - "dependencies": { - "@flowershow/remark-wiki-link": "^1.1.2", - "gray-matter": "^4.0.3", - "knex": "^2.4.2", - "remark-gfm": "^3.0.1", - "remark-parse": "^10.0.1", - "sqlite3": "^5.1.6", - "unist-util-select": "^4.0.3" - }, - "bin": { - "mddb": "dist/src/bin/index.js" - } - }, - "node_modules/@flowershow/remark-wiki-link": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/@flowershow/remark-wiki-link/-/remark-wiki-link-1.2.0.tgz", - "integrity": "sha512-CI4+jjoZ0n036tZBjvMX4XyVAzHxU/6hDrl78511VSgwnRAYMEo6Jqxg9suq+mW0FlREz3mSQGpsbXcc92sqhA==", - "deprecated": "This package has been renamed to `@portaljs/remark-wiki-link`. Please use it instead.", - "dependencies": { - "mdast-util-to-markdown": "^1.5.0", - "mdast-util-wiki-link": "^0.0.2", - "micromark-util-symbol": "^1.0.1" - } - }, "node_modules/@gar/promisify": { "version": "1.1.3", "resolved": "https://registry.npmjs.org/@gar/promisify/-/promisify-1.1.3.tgz", @@ -9639,11 +9609,11 @@ } }, "node_modules/mddb": { - "version": "0.1.9", - "resolved": "https://registry.npmjs.org/mddb/-/mddb-0.1.9.tgz", - "integrity": "sha512-d3B5zArnWDqKN1Blq6hGtfr3HTHUKK/GS95b4OZqcyDPvUP4JnYuWHDjyoJ0tSgDKH6ybB6WdnnI3tcHQvRTyw==", + "version": "0.2.1", + "resolved": "https://registry.npmjs.org/mddb/-/mddb-0.2.1.tgz", + "integrity": "sha512-oZd+STPy5HrSjHz7B4MzceNCxcddqOPQSWX2BQYxe2CV0vTd5/REf98cOM5MNAxK5UpYgvziotSq9hqZoW6G/g==", "dependencies": { - "@flowershow/remark-wiki-link": "^1.1.2", + "@portaljs/remark-wiki-link": "^1.0.4", "gray-matter": "^4.0.3", "knex": "^2.4.2", "remark-gfm": "^3.0.1", diff --git a/examples/openspending/package.json b/examples/openspending/package.json index 759d5068..3fc3134a 100644 --- a/examples/openspending/package.json +++ b/examples/openspending/package.json @@ -12,7 +12,6 @@ "test": "vitest" }, "dependencies": { - "@flowershow/markdowndb": "^0.1.8", "@githubocto/flat-ui": "^0.14.1", "@headlessui/react": "^1.7.14", "@heroicons/react": "^2.0.18", @@ -36,7 +35,7 @@ "eslint-config-next": "13.4.3", "flexsearch": "0.7.21", "isomorphic-unfetch": "^4.0.2", - "mddb": "^0.1.9", + "mddb": "0.2.1", "next": "13.4.3", "next-mdx-remote": "^4.4.1", "next-seo": "^6.0.0",