guida-fediverso/README.md

65 lines
2.2 KiB
Markdown
Raw Normal View History

2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
# FEDIVERSE GUIDE
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
![website logo](./source/img/touch/favicon-32x32.png?raw=true) A quick look into Fediverse networks
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
### [Important](#notes)
2018-03-22 03:48:05 +01:00
2018-03-24 20:13:00 +01:00
- "World" text on postActiv page is by @Maiyannah Bishop, main postActiv developer
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
### [Goals](#goals)
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
1. **Road Making**: Provide links to information scattered around the internet. Make it easier for newcomers to get acquainted with the idea in general and with every federated network in particular.
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
2. **Team Building**: Unite all federated social networks under 'Fediverse' name. Highlight the sense and spirit of a Fediverse community.
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
### [Contributing](#contributing)
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
Read [Contributing](./CONTRIBUTING.md)
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
### [Structure](#structure)
2018-03-22 03:48:05 +01:00
#### Fediverse page
2018-06-04 02:51:51 +02:00
*Data located in*: `/source/_data/fediversei18n.json` file
2018-03-22 03:48:05 +01:00
#### Chronicles page
*Data located in*: `/source/_posts` folder
2018-06-04 02:51:51 +02:00
#### Knowledge page
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
*Data located in*: `/source/_data/knowledge.json` file
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
#### Each network page
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
*Data located in*: `/source/_data/..network.json` and `/source/_data/world18n.json` files
2018-03-22 03:48:05 +01:00
#### Portal page
2018-06-04 02:51:51 +02:00
Supposed to link to a page helping to choose a server on any network (just an idea, for now)
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
### [Theme File Structure](#theme)
2018-03-22 03:48:05 +01:00
- Develop styles in `/themes/starter/assets/scss`
- Develop scripts in `/themes/starter/assets/scripts`
2018-06-04 02:51:51 +02:00
### [Setup](#setup)
2018-03-22 03:48:05 +01:00
1. Run `npm install` in main project's folder
2. Run `gulp` in `/themes/starter` folder
3. In second terminal, run `hexo server` in main folder, to start the server and preview at localhost
2018-06-04 02:51:51 +02:00
### [Translating](#translating)
2018-03-22 03:48:05 +01:00
2018-06-04 02:51:51 +02:00
Maintaining several website translations will require extra work. Please, read [discussion](https://gitlab.com/fediverse/fediverse.gitlab.io/issues/9).
2018-03-22 03:48:05 +01:00
Adding another language requires additions to `_config` file and `/themes/starter/languages` folder.
Mandatory for translating:
- create lang folder (`/source/*lang*`)
- common strings (`/themes/starter/languages/en`)
- `/source/_data` folder: fediversei18n.json, worldi18n.json
2018-06-04 02:51:51 +02:00
Translating Chronicles and Knowledge page content doesn't make sense (?). They will be mostly a collection of external English articles. If you're willing to become a permanent news contributor in another language and to search for Fediverse news in that language, let's discuss it in the issue.