Faciliter les contributions sur GitHub


#21

Hello à tous, Ce qui serait bien ce mettre à dispo une doc même minimale sur Gladys, son architecture, les fichiers qui le compose ce qui permettrait de mieux comprendre son fonctionnement. Je pense qu’une idée plus claire de tout cela permettra d’avoir plus de contributeurs prompts à apporter des idées, participer aux développement de modules, aux tests sur différents matériels, à des tutoriels, contribuer via Patreon bref in fine de faire avancer plus vite le projet. Ce qui serait bien aussi serait d’adopter un langage moins abscons avec moins d’acronymes, d’abréviations ou d’anglicismes à tout va dans les forums pour une compréhension minimale pour tous, nous avons une belle et riche langue, je n’ai rien contre les anglicismes quand il n’y a pas d’équivalents en français mais des fois il y en a pléthore je trouve…y compris par le géniteur et exégète de ce projet ! :wink:


#22

D’accord avec toi sur l’ensemble de ton post.
Voici quelques docs (je pense que tu as déjà dû les lire, mais ça répond à certains points que tu soulèves) :

Pour ce qui est de l’anglais, c’est vrai que @pierre-gilles aime bien caler quelques mots par ci par là mais malheureuseument, c’est une déformation professionnelle je pense.
En effet, le code (au sens large, pas seulement Gladys) est international et basé sur l’anglais, on a beau avoir une belle langue, c’est comme ça…
Donc quand ils (les devs) donnent des explications, c’est souvent basé sur des fonctionnalités en langue anglaise et dont le sens pourrait être mal compris en traduisant à tout va.

(Mais ça n’enlève en rien le fait que le papa de Gladys aime bien placer des mots en anglais… :p)


#23

Bonjour Hamtaro, Certes je l’ai lu la doc mais je parlais d’une doc qui permettrait de faire une install de Gladys sur n’importe quel config en partant de 0 (et surtout pouvoir ainsi faire une install sur d’autres matos), là dans la doc on reste sur cantonné sur du Raspi à cause de l’image et c’est bien dommage. Il serait déjà plus simple bien de faire un package de déploiement genre sudo apt-get install gladys . Pour l’anglais, j’ai commencé à coder pro en vb3 (et même le VbDos avant) en 95, lisp(Autocad), et je parles pas du GFA Basic sur Atari 520 ni du Qbasic sur Sinclair QL en 85…Snif la belle époque ! Non je déconnes, on rêvait des machines et leurs possibilités d’aujourd’hui avec les frustrations qui découlaient de leurs limitations d’alors ! Donc, la langue anglaise on en bouffait des km via les bouquins d’infos ou docs rarement traduit (la prog des API, DLL de Windows fut un délice intellectuel dont j’ai étonnement évité la calvitie ! :wink: ), la langue de Shakespeare ne me déranges pas outre mesure mais elle, je pense, quand elle est mélangée donne une impression plus floue de l’ensemble…Donc, je reste preneur d’une doc qui me permettrait de faire une install sur une VM (que ce soit sur une VM Linux, Mac, Windows, ReactOS ! J’ai acheté le Starter Pack, contribue sur Patreon (également pour ReactOs, Openmediavault ) mais cela me frustres de ne pas pouvoir déployer Gladys sur d’autre matos surtout sur une VM (je suis en train de regarder pour le déployer sur Qemu). Bref, pour résumer ce qu’il manque à ce jour c’est une solution d’install simple voire triviale…et donc d’une doc ad hoc !!! Une bonne âme pour s’y coller ? :weary:


#24

Je ne sais plus trop où , mais tu trouveras sur le forum des membres qui n’utilisent pas de RPi, mais des VM ou des NAS Syno pour faire tourner Gladys :wink:

Edit : Lien pour un exemple sur NAS Synology :wink:

Edit 2 ; Lien pour un exemple sur VM :wink:


#25

on est d’accord, on peut surement tout trouver sur un forum mais rien ne remplace une doc.
idem pour faire des scripts, je pense que ça manque de doc. celle existante ne permet pas de comprendre la logique Gladys. c’est ce qui me freine pour l’instant dans l’utilisation de gladys, pourtant l’informatique c’est mon métier mais je n’ai pas envie de passer qq heures à éplucher les forums. je bien bien d’accord que c’est facile à dire :slight_smile:


#26

Je suis d’accord sur l’idée d’une doc d’install multi platforme.

Pour te rassurer, Gladys tourne sur une VM ubuntu chez moi, d’ailleurs VM ou pas, c’est sur une distri linux.
Ce qui compte c’est la distri (ubuntu, centos…) et la techno (docker, iso…)


#27

Je comprends le besoin de doc, mais il ne faut pas oublier que celà impose de la maintenir / test etc…

De plus l’installation est spécifique à chaque plateforme et au besoin de chacun ( L’installation sur Ubuntu/Debian ne sera pas la même que sur RedHat / Mac / Windows / WSL ) et ma conf docker n’est valable que pour mon installation.

De plus le README du projet contient déjà les infos nécessaires ( N’est pas détaillé l’installation sur VM )


Vous voulez une page comme celle ci ?


#28

Et le gagnant du jour est…Andro ! :clap:Chouette tu vas donc pouvoir nous faire un tuto :writing_hand: sur ton installl :laughing: !! Plus sérieusement, j’ai galéré par exemple sur l’install et le paramétrage d’Openmediavault sur mes HP N40L et notamment sur le rsync entre les deux machines, j’ai fini par trouver après moult essais et partagé mes infos ensuite mais cela m’as pris du temps que l’on a pas toujours (en ce moment je refais toute l’éléctricité de la maison pour la domotisation, 100 câbles tirés depuis le tableau ! :tired_face: ), idem pour mon firewall IpFire. Donc une chtite doc sur le fonctionnement et sur l’install générique pas à pas serait pas du luxe… Merci VonOx pour les liens, j’essaierais ce WE sur VM car cela permet ensuite de faire des test sans casser sa config tous les 4 matins !


#29

Je pensais à une page de ce type https://docs.cozy.io/en/tutorials/selfhost-debian/

Mais c’est clair que ca demande un peu de boulot pour faire une doc propre et fiable :wink:

Gladys tourne chez moi depuis un bail donc je t’avouerais que j’ai plus trop les commandes en tête.
Après c’est pas compliqué en soit.

En synthèse, et sans aucune vocation à être une doc, tu dois:

  1. installer une bdd
  2. installer node.js
  3. cloner le repo gladys
  4. installer les dependances (npm / yarn)
  5. builder les assets et initialiser la base
  6. installer pm2 et le configurer
  7. installer nginx et le configurer en reverse proxy https

Edit:

ben en fait @C4rlit0 à déjà + ou - tout écrit içi

Les commandes valent (à peu de chose près) pour toutes les distri à base de debian


Parlons de Gladys V4