/5e-drs

Sources du Document de Référence Système pour le jeu de rôle Héros & Dragons

GNU General Public License v3.0GPL-3.0

5E DRS Sources Logo

5E DRS

Ici se trouvent les sources du Document de Référence Système pour jeux de rôle en OGL 5E.

Documentation

Publication

Seuls les contenus soumis à la licence OGL sont publiés. Si des contenus sont manquants, demandez-vous en premier lieu s'ils sont sous licence OGL ou pas. Exemples :

  • Les textes de description et d'ambiance ne sont pas OGL

Correction de contenu

Si vous relevez des erreurs, il suffit d'éditer le fichier source directement sur Github. Un fork sera automatiquement généré, et vous pourrez effectuer une pull request une fois votre correction commitée. La pull request sera acceptée si elle est valide. Si vous ne souhaitez pas (ou ne pouvez pas) corriger une erreur vous-même, vous pouvez créer une issue avec le label documentation. Soyez le plus précis possible en incluant des liens vers les contenus erronés et les sources des corrections. L'erreur sera corrigée si elle est avérée.

Développement

Pour travailler sur le projet, vous devrez au préalable télécharger les sources :

git clone git@github.com:em-squared/5e-drs.git

Puis installer les dépendances :

cd 5e-drs
yarn install

ou

cd 5e-drs
npm install

Et lancer le service en local :

yarn dev

ou

npm run dev

Production

Au vu de la quantité de fichiers à traiter, le build est gourmand en mémoire et en ressource processeur. Sur une configuration moyenne, le build prend un peu moins de 2 minutes, mais peut monter à 5 minutes sur des configurations plus modestes. La consommation mémoire peut monter jusqu'à 5Go. Il faudra donc impérativement augmenter la plage mémoire allouable à Node lors du build :

export NODE_OPTIONS=--max-old-space-size=8192

Pour compiler le projet en vue d'un déploiement, vous devrez vous assurer qu'il ne contient pas de lien internes morts :

yarn check-md

ou

npm run-script check-md

Puis lancer la compilation :

yarn build

ou

npm run build

Vous pouvez ensuite tester le site statique compilé en lançant un serveur local :

cd docs/.vuepress/dist
python -m SimpleHTTPServer 8081

Le site statique sera accessible sur http://localhost:8081

Soutien

Si le cœur vous en dit, vous pouvez soutenir le projet sur Ko-fi. Ça sera grandement apprécié. Le site est entièrement gratuit et ne souffre d'aucune publicité. Aucun revenu n'est donc généré par son biais.

Licence

Le code source applicatif (hors contenus donc) est sous licence GPLv3. Vous êtes donc libres de le copier, le modifier et le redistribuer à condition d'en conserver la licence d'origine.