Commit dd50669d authored by Johan Richer's avatar Johan Richer
Browse files

Merge 2 FAQ repos

parent 0c2e8686
Pipeline #284 failed with stages
in 1 minute and 25 seconds
module.exports = {
title: 'GitLab Documentation',
description: 'Documentation for the Digital Transport Resource Center',
base: '/gitlab-doc/',
themeConfig: {
sidebar: [
'/data-faq/',
'/doc-faq/'
],
sidebarDepth: 1,
repo: 'https://git.digitaltransport4africa.org/doc/gitlab-doc',
docsDir: '.',
editLinks: true,
editLinkText: 'Éditer sur GitLab',
nav: [
{text: 'DT4A', link: 'https://digitaltransport4africa.org/'},
{text: 'Resource Center', link: 'https://git.digitaltransport4africa.org/'},
],
lastUpdated: 'Dernière mise à jour',
}
}
![Build Status](https://gitlab.com/samdbeckham/vuepress-gl-pages/badges/master/build.svg)
---
Example [VuePress][project] website using GitLab Pages.
Learn more about GitLab Pages at https://pages.gitlab.io and the official
documentation https://docs.gitlab.com/ce/user/project/pages/.
---
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [GitLab CI](#gitlab-ci)
- [Building locally](#building-locally)
- [GitLab User or Group Pages](#gitlab-user-or-group-pages)
- [Did you fork this project?](#did-you-fork-this-project)
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
## GitLab CI
This project's static Pages are built by [GitLab CI][ci], following the steps
defined in [`.gitlab-ci.yml`](.gitlab-ci.yml):
```
image: node:9.11.1
pages:
cache:
paths:
- node_modules/
script:
- yarn install
- yarn build
artifacts:
paths:
- public
only:
- master
```
This sets up a `node9.11.1` environment, then uses `yarn install` to install dependencies and `yarn build` to build out the website to the `./public` directory.
It also caches the `node_modules` directory to speed up subsequent builds.
## Building locally
This project uses [yarn](https://yarnpkg.com), you'll need to install this globally before you can get started.
```
npm install -g yarn
```
Then you need to install the project dependencies:
```
yarn install
```
Now you're ready to go.
To run the local dev server just use the following command:
```
yarn start
```
Your website should be available at [http://localhost:8080/vuepress]
*Read more at VuePress' [documentation][].*
## GitLab User or Group Pages
To use this project as your user/group website, you will need one additional
step: just rename your project to `namespace.gitlab.io`, where `namespace` is
your `username` or `groupname`. This can be done by navigating to your
project's **Settings**.
Read more about [user/group Pages][userpages] and [project Pages][projpages].
## Project name
You'll need to set the correct base in docs/.vuepress/config.js.
If you are deploying to https://<USERNAME or GROUP>.gitlab.io/, you can omit base as it defaults to "/".
If you are deploying to https://<USERNAME or GROUP>.gitlab.io/<REPO>/, (i.e. your repository is at https://gitlab.com/<USERNAME>/<REPO>), set base to "/<REPO>/".
## Did you fork this project?
If you forked this project for your own use, please go to your project's
**Settings** and remove the forking relationship, which won't be necessary
unless you want to contribute back to the upstream project.
[ci]: https://about.gitlab.com/gitlab-ci/
[project]: https://vuepress.vuejs.org/
[install]: https://vuepress.vuejs.org/guide/getting-started.html
[documentation]: https://vuepress.vuejs.org/guide/
[userpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#user-or-group-pages
[projpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#project-pages
----
Forked from @samdbeckham
# Documentation for the Digital Transport Resource Center
# Data FAQ
Here are some of the most Frequently Asked Questions about data on [Digital Transport for Africa](http://digitaltransport4africa.org/) (DT4A). Feel free to [ask new questions](https://git.digitaltransport4africa.org/doc/gitlab-doc/issues/new)!
## What's data?
**Data are just files on your computer**: documents, spreadsheets, images... A dataset is a collection of data, sometimes multiple files in a compressed ZIP file (`.zip`), sometimes multiple sheets in an Excel file or a even a single CSV file (`.csv`) with multiple column.
[GTFS](https://gtfs.org/) (also known as GTFS-Static, not to be confused with GTFS-RT) is a common format to share public transit data. It's a ZIP file (`GTFS.zip`) containing text files (`.txt`) with [comma-separated values](https://en.wikipedia.org/wiki/Comma-separated_values).
## What's open data?
Open data is data that is been shared in a way that others have the rights to use and republish it. You do this by sharing your data with an open data license (e.g. [CC0](https://creativecommons.org/publicdomain/zero/1.0/) or [ODbL](https://opendatacommons.org/licenses/odbl/summary/index.html)). Without a license, nobody knows if they can use this data: it's not open.
## What's Gitlab?
The DT4A project provides a platform to upload, publish and share data, accessible here: [git.digitaltransport4africa.org](http://git.digitaltransport4africa.org/). It's an instance of the open source tool called Gitlab. Gitlab is the open source equivalent of [Github](http://github.com/). DT4A's Gitlab is not to be confused with [Gitlab.com](http://about.gitlab.com/). Both are independent and separate websites.
For the sake of simplicity, we call "Gitlab" or "Resource Center" the website at git.digitaltransport4africa.org. It looks like this:
![](../assets/gitlab_home_page.png)
## How to register on Gitlab?
In order to have to access to most features on Gitlab, such as uploading data, you will need to register a personal account. To do so, [click here](https://git.digitaltransport4africa.org/users/sign_in?redirect_to_referer=yes#register-pane) and complete the Register form:
![](../assets/signup_page.png)
You can also directly sign in with a user account on Gitlab.com or Github.com, if you already have one there, at the bottom of the page.
If you've successfuly registered an account and logged in, you'll see your username by clicking on the menu at top right corner:
![](../assets/username_menu.png)
## How to upload data?
First, please [register an account on Gitlab](#how-to-register-on-gitlab) if you haven't done so already.
When you're logged in as a user, you can create a "Project", which is a repository where you will be able to deposit files. To do so, click on [New project](https://git.digitaltransport4africa.org/projects/new) at the top of the page:
![](../assets/new_project_button.png)
1. Enter a project name, for example the name of the city if you want to upload a GTFS dataset for that location;
2. Select "Initialize repository with a README";
3. Click on "Create project" (leave the rest as is):
![](../assets/create_project_form.png)
Congratulations, you have created your first repository! It looks something like this:
![](../assets/new_project_success.png)
You can now start **uploading** files in this repository, to do so click on the + menu then "Upload file":
![](../assets/upload_button.png)
An "Upload New File" menu will appear
1. "Click to upload" then find the file you want to upload from your computer;
2. Write a comment to describe your action (also called a "commit");
3. Click on "Upload file":
![](../assets/upload_menu.png)
Congratulations, you have uploaded your first bit of data!
![](../assets/upload_success.png)
You can share this link with everyone now on the Internet now.
## How to add a license?
_Coming soon_
## How to create a new file?
On Gitlab you can create a file directly within the interface, for example to write new documentation. To do so, go to your repository where you want to create a new file, click on the + menu then "New file":
![](../assets/new_file_button.png)
1. Add your text;
2. Add a filename (for example `README.md`);
3. Write a comment to describe your action (also called a "commit");
4. When you're finished, click on "Commit changes" at the bottom:
![](../assets/new_file_page.png)
## How to edit a document?
On Gitlab you edit text files directly within the interface, for example to edit existing documentation. To do so, go to your repository where you want to edit a file and click on the file:
![](../assets/file.png)
Then click on the "Edit" button:
![](../assets/file_edit_button.png)
Modify the text, write a "commit message" to describe your action and when you're finished, click on "Commit changes" at the bottom.
## How to document my data? What's Markdown?
On Gitlab, each repository can be documented by creating a text file called a "README". It will be displayed by default when you access the repository's page, so it's pretty useful to have one!
It's best to format the README using Markdown. A Markdown document is just a basic text file ending with `.md`, and using some simple formating. If you're not familiar with it, please take a look at [this guide](https://daringfireball.net/projects/markdown/syntax), or read [the Wikipedia article about it](https://en.wikipedia.org/wiki/Markdown).
To document your data, create a file named `README.md` or edit it if you already have one in your repository. (See How to create a new file? and How to edit a document?)
## What's a "project"? What are "groups"?
In Gitlab, a "project" is a repository (or "repo") where users can deposit files; a bit like a folder on your computer. Each project is managed by one or several users who have rights on it. A "group" is just a folder to bundle several repositories together.
New users with basic access can only create projects in their own username group, whereas administrators can create new public groups and do many other things to organize the Gitlab platform.
## How is Gitlab organized?
As part of DT4A, Gitlab is jointly administered by [AFD](https://afd.fr/) and [WRI](https://wri.org), who make decisions on the way it is organized and managed.
Once [you've registered](#how-to-register-on-gitlab), your account on Gitlab has the lowest level of permissions. Further access & permissions can be given to you by administrators according to your status.
Gitlab repositories are categorized in several [public groups](https://git.digitaltransport4africa.org/explore/groups):
![](../assets/gitlab_groups.png)
If you want to a repository you've created to one public group, please contact an administrator.
doc-faq @ 4a8fff9a
Subproject commit 4a8fff9ab221f3008f9365ebc4a6379347f834fa
module.exports = {
title: 'GitLab ❤️ VuePress',
description: 'Vue-powered static site generator running on GitLab Pages',
base: '/vuepress/',
dest: 'public'
}
\ No newline at end of file
---
home: true
heroImage: /hero.png
features:
- title: Simplicity First
details: Minimal setup with markdown-centered project structure helps you focus on writing.
- title: Vue-Powered
details: Enjoy the dev experience of Vue + webpack, use Vue components in markdown, and develop custom themes with Vue.
- title: Performant
details: VuePress generates pre-rendered static HTML for each page, and runs as an SPA once a page is loaded.
footer: MIT Licensed | Copyright © 2018-present Evan You
---
\ No newline at end of file
......@@ -7,8 +7,8 @@
"license": "MIT",
"private": false,
"scripts": {
"start": "vuepress dev docs",
"build": "vuepress build docs"
"start": "vuepress dev",
"build": "vuepress build"
},
"dependencies": {},
"devDependencies": {
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment