Chapril/bd.chapril.org-bd: Bifurcation de GéGé, le Générateur de Grise Bouille proposé par Framasoft - bd.chapril.org-bd - La forge de l'April
Chapril
bd.chapril.org-bd
Fork
You've already forked bd.chapril.org-bd
forked from
gee/bd-chapril
Code
Issues
Pull Requests
Releases
Wiki
Activity
181
Commits
Branches
10
Tags
main
Clone
Open with VS Code
Open with VSCodium
Open with Intellij IDEA
Download ZIP
Download TAR.GZ
Download BUNDLE
fhenry2
8d18ab4a4d
Check fix
2026-01-23 17:22:12 +01:00
.vscode
VSC Workspace added
2024-12-29 23:40:46 +01:00
font
Font directory cleaned
2024-12-31 12:12:14 +01:00
images
Chapril banner inserted
2025-01-07 10:53:47 +01:00
lib
Check fix
2026-01-23 17:22:12 +01:00
sounds
Sound files moved in directory
2024-12-24 14:11:37 +01:00
styles
Transparency in focus images
2025-02-05 19:04:23 +01:00
tools
Check fix
2026-01-23 17:22:12 +01:00
toons
Lama ++
2025-01-08 18:42:33 +01:00
.gitignore
Toon PNG only
2025-01-08 18:39:59 +01:00
.prettierignore
Ragaboom not minified
2026-01-23 16:12:12 +01:00
bdchapril.js
Formatted
2025-01-09 22:08:47 +01:00
COPYRIGHT.md
JQuery upgraded
2026-01-23 17:08:18 +01:00
eslint.config.js
dist/
directory not linted
2025-01-09 21:39:34 +01:00
favicon.ico
Favicon added
2024-12-24 13:52:45 +01:00
index.html
Check fix
2026-01-23 17:22:12 +01:00
LICENCE.md
GNU GPLv3 added
2024-12-22 09:13:42 +01:00
manifest.json
PWA Manifest added
2024-12-22 17:58:00 +01:00
package.json
Check fix
2026-01-23 17:22:12 +01:00
prettier.config.js
Better practice
2025-01-09 22:05:41 +01:00
README.md
JQuery’s upgrade
2026-01-23 16:22:51 +01:00
sw.js
Cache list externalized from service worker
2024-12-31 20:20:31 +01:00
README.md
BD Chapril
Un ancien générateur de BD qui a bien vieilli.
Contraintes
Le lecteur doit être averti que cette bifurcation du projet Comic Gen est développé dans une distribution de GNU/Linux tel que Debian.
environnement de travail nécessite l
installation du paquetage
imagemagick
dont dépend
tools/mkmini.sh
Installation
Une fois le dépôt téléchargé les données doivent être construites avant le déploiement.
Pour se faire toutes les images doivent être placées dans
toons/
Chaque image
${IMG}.png
doit être associée à une miniature
${IMG}_mini.png
de 60
60 pixels.
Les miniatures sont générées via cette commande :
./tools/mkmini.sh
Reste la création des fichiers de donnée par cette commande :
./tools/mkdata.sh
Une dernière étape consiste à copier la charge utile dans un répertoire
dist/
à déployer pour un site Web statique :
./tools/mkdist.sh
Quand on change le contenu de
toons/
ces trois commandes doivent être exécutées.
Un changement dans la liste des fichiers statiques à exposer impactera dans le code de
tools/mkdata.sh
Démonstration
Site :
Paternité
Auteurs : Willian Carvalho (willianpc) et
Gee
Dépôts des projets :
Comicgen :
Ragaboom :
Article :
Gestion des caches
Initialement le cache était géré par l
API Application Cache.
Cette API ayant été dépréciée puis obsolète, un
service worker
sw.js
) a pris le relai.
Pour les curieux un article sur l
Application Cache :
Développement
Déploiement local
Via Lite Server
environnement de développement comprend le paquet Node
lite-server
Ainsi la partie Node du projet n
est pas nécessaire au déploiement en production.
outil est installé comme suit :
cd
tools/ls/
npm install
Pour essayer localement l
application on passe par cette commande :
cd
tools/ls/
npm run serve
Un onglet nouveau apparaît alors dans le navigateur Web par défaut.
Le fichier
tools/ls/bs-config.json
se charge de paramétrer le serveur local selon les options de
BrowserSync
Via Static Web Server
Une solution alternative est
Static Web Server
. Ce petit serveur de site statique de 8 Mio peut être installé comme suit.
cd
tools/sws/
cargo install --root ./ static-web-server
mv bin/static-web-server ./
rmdir bin/
installation de
Rustup
est recommandée pour compiler des applications en Rust.
Reste à lancer le serveur via
./tools/sws/static-web-server -w tools/sws/config.toml
et à accéder à l
application Web via l
URL
Pour s
assurer que le charge utile dans
dist/
est bien opérationnelle juste avant son déploiement la configuration
tools/sws/config.prod.toml
est disponible.
Dépendance de
JQuery
Installation
La variante actuelle de JQuery est
Slim
Elle exclut les modules
ajax
et
effects
Le moyen le plus sûr d
installer la version
VERSION
passe par le dépôt Git officel à cloner temporairement.
# Depuis la racine du dépôt local
mkdir /tmp/jquery
git clone -b
"VERSION"
cd
/tmp/jquery/
npm install
npm run build -- --esm --slim --filename
jquery.slim.module.js
mv /tmp/jquery/dist/jquery.slim.module.min.js lib/
Débogage
Pour inclure JQuery dans le débogage
lib/jquery.slim.module.min.js
doit contenir une ligne supplémentaire :
echo
'//# sourceMappingURL=jquery.slim.module.min.map'
>> lib/jquery.slim.module.min.js
Il doit aussi s
accompagner du fichier de correspondance
lib/jquery.slim.module.min.map
mv /tmp/jquery/dist/jquery.slim.module.min.map lib/
Corriger avec
ESLint
et
Prettier
À fin de corriger les fautes de syntaxe ESLint peut être installé via cette commande :
npm install --production
false
Pour vérifier le code de tous les fichiers on exécutera
npx eslint
Pour cibler un fichier
file.js
spécifique ce sera
npx eslint file.js
Le formateur Prettier est inclus dans l
installation pour améliorer encore la visibilité du code.
Il formate un fichier
file.js
ainsi :
npx prettier --write file.js
Nouvelle étiquette
Le mainteneur peut publier une version nouvelle du projet en passant par l
outil
tools/newtag.sh
Une version a une syntaxe sémantique comme
1.2.3
./tools/newtag.sh 1.2.3
Puis le mainteneur est invité à compléter la note du livrable par une liste de changements par rapport à la version qui précède.
Les étiquettes doivent pointer sur un
commit
de la branche
main
View Git Blame
Copy Permalink
Description
Bifurcation de GéGé, le Générateur de Grise Bouille proposé par Framasoft
bd
service
Readme
9.6
MiB
Languages
JavaScript
68.3%
HTML
14.3%
CSS
9.5%
Shell
7.9%