nxs5899 / tosdr-build

System to generate ToS;DR projects

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

This is the source code for www.tosdr.org. You should find more information about the project itself on the website.

The data specification is available on the wiki.

Personal information

This repo might contain information that was not intended to be public. In that case, please open a PR here or send us an email at team at tosdr dot org.

Clone this repository

There are git submodules in this repository. To automatically have them all, clone this repository with the git clone --recursive option. Alternatively, run git submodule init and git submodule update to pull in the submodules.

Build

Most of the website's source files are located in the src/ directory (although unfortunately some of it is still intermingled with the build files).

To build:

  1. Make sure you have the git submodule in the dist/ folder and that it is up-to-date (see above).

    The source files are used to generate the content of the tosdr.org repository, generated in the dist/ folder.

  2. Run npm install in the root of this repository to make sure you have the required packages.

  3. Make the changes you wish to make to the source files in this repository.

  4. Run grunt or ./node_modules/.bin/grunt in the root of this repository.

  5. Check whether the output in the dist/ directory is looking as intended.

  6. Commit and push both repositories.

  7. To publish the new version of the website, assuming you have 5apps set up as a remote in the dist/ folder, run git push 5apps master. But be careful: this updates the live site! Ask @hugoroy or @michielbdejong if you don't have permission

Develop other applications

API: http://www.tosdr.org/api.html

Also have a look at other apps, like the browser extensions: https://github.com/tosdr

Core developpers

Hosting

People who have access to the hosting:

License

AGPL-3.0+ (GNU Affero General Public License, version 3 or later)

See https://tosdr.org/legal.html for more details on the legal aspects of the project.

About

System to generate ToS;DR projects

License:GNU Affero General Public License v3.0


Languages

Language:HTML 71.3%Language:JavaScript 10.6%Language:CSS 8.8%Language:Shell 8.7%Language:PHP 0.3%Language:Makefile 0.1%Language:Python 0.1%