scaffolds | ||
source | ||
themes/starter | ||
.domains | ||
.editorconfig | ||
.gitignore | ||
.gitlab-ci.yml | ||
_config.yml | ||
CONTRIBUTING.md | ||
GUIDELINES.md | ||
letsencrypt_authenticator.sh | ||
letsencrypt_cleanup.sh | ||
letsencrypt_generate.sh | ||
LICENSE | ||
package-lock.json | ||
package.json | ||
README.md |
FEDIVERSE GUIDE
A quick look into Fediverse networks
Goals
-
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.
-
Team Building: Unite all federated social networks under 'Fediverse' name. Highlight the sense and spirit of a Fediverse community.
Contributing
Read Contributing
→ Check out our Wiki ←
Structure
Fediverse page
Data located in: /source/_data/fediverse.json
file
Chronicles page
Data located in: /source/_posts
folder
Knowledge page
Data located in: /source/_data/knowledge.json
file
Each network page
Data located in: /source/_data/..network.json
and /source/_data/world.json
files
Portal page
Supposed to link to a page helping to choose a server on any network (just an idea, for now)
Theme File Structure
- Develop styles in
/themes/starter/assets/scss
- Develop scripts in
/themes/starter/assets/scripts
Setup
This site uses Hexo static generator. Follow these steps to spin up a local development environment:
- Run
npm install
in main project's folder - Run
gulp
in/themes/starter
folder - In second terminal, run
hexo server
in main folder, to start the server and preview at localhost
Translating
Maintaining several website translations will require extra work. Please, read discussion.
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: fediverse.json, world.json
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.