Page 1 sur 1

[Tutos] organisation

Posté : 08 août 2017, 15:11
par Frosty
Salut !

Voici une proposition d'organisation / ménage pour actualiser la section "Tutos".

:arrow: :arrow: :arrow: Proposition de nouvelle organisation

Il est possible d'intervenir directement sur GitHub pour participer à la rédaction des nouveaux tutoriels.


Tutos qui me paraissent obsolètes (mettre à jour ou supprimer ?)
  • Le DHTML (je propose de supprimer)
  • Les règles pour réussir son site web (pas mal d'infos obsolètes, moins de public aujourd'hui pour ce type de conseils...)
  • Autorun de CD ROM
  • JavaScript et les frames (mettre à jour : parler en priorité d'iframes plutôt que des frames classiques)

Tutos "hors sujet" (=> envisager un autre site ?)
  • Tous les tutoriaux PHP
  • Les feuilles de style CSS
  • Introduction aux normes du W3C
  • Les balises META
  • Protéger un répertoire de site web
-------------------------------------------------------------------------------

Remarques :

- J'ai certainement oublié des choses
- Ceci exprime mon avis personnel sur la structure du site, à revoir au minimum par le webmaster

Re: [Tutos] organisation

Posté : 08 août 2017, 16:05
par webmaster
Tu es déchainé Frosty !

Je suis d'accord avec presque tout. Sauf les frames. C'est encore pas mal utilisé dans les iframes en fait.

L'immense majorité de l'audience vient par la référence du langage depuis une recherche google.
Les tutos sont a revoir complétement sans hésitation.

Pour le moment, ils sont codés en dur dans une page html.
Ce n'est pas l'idéal du tout pour la maintenance et la mise à jour.
Est-ce qu'il existe des outils pour la coloration syntaxique et la mise en forme de code ?

Re: [Tutos] organisation

Posté : 08 août 2017, 16:43
par Frosty
Salut, merci pour ton retour ;)

Pour les frames, je pense que c'est plutôt une mise à jour "orientée iframe" dont il y aurait besoin, car les frames "classiques" ont je crois disparu de la circulation.
Je vais mettre à jour mon post initial.
Pour le moment, ils sont codés en dur dans une page html.
Ce n'est pas l'idéal du tout pour la maintenance et la mise à jour.
En effet, mais à voir en fonction des besoins. Dans un premier temps, si on n'est que 2 à gérer le contenu ce n'est peut être pas la peine de tout chambouler.
Si par contre le site repart bien et qu'on se retrouve à une dizaine de contributeurs à intervenir très souvent sur les tutos (on peut inclure aussi la rubrique "Scripts" dans cette histoire), là oui il conviendra d'envisager d'autres solutions, comme un CMS tout prêt à intégrer au site, si possible avec la même base de comptes que celle du forum (cela dit, tant qu'on se limite à une dizaine de users, ce ne serait pas la mort non plus ;) )
Est-ce qu'il existe des outils pour la coloration syntaxique et la mise en forme de code ?
J'ai trouvé ça qui pourrait t'intéresser : https://highlightjs.org/ avec la possibilité de télécharger un package "léger" qui ne contient que ce qu'on souhaite.

Re: [Tutos] organisation

Posté : 08 août 2017, 23:00
par Frosty
@QuentinC : pour répondre à ton intervention dans un autre sujet
Les tutoriels: on a encore un avantage, les vrais bons tutos sur JavaScript à jour et en français sont encore rares. Histoire de repartir du bon pied, je pense qu'il faudrait commencer dès le début par enseigner ES2015+. Ca ferait un bon axe de différenciation et comme de plus en plus de monde se fiche pas mal d'IE, même si on n'a pas de transpileur c'est de moins en moins grave.
On peut toujours expliquer comment rendre son code compatible avec IE et les anciens navigateurs, de même que à quoi ressemblait JavaScript dans sa jeunesse plus tard.

S'il y a des motivés pour Angular 1 ou 2, React, TypeScript ou autre chose, go! Les ressources en français ne se bousculent pas non plus; je peux éventuellement aider pour Angular.
Évidemment, entre-temps Node.js est apparu et il serait aussi de bon ton d'en parler avec ses deux principales utilisations possibles: JavaScript côté serveur et aussi en tant qu'outil d'automatisation.
Globalement d'accord avec toi, même si je pense que certains tutos peuvent être "sauvés" en étant un actualisés (même si c'est par petites touches).
Tutoriels PHP: vu qu'on n'est pas sur toutphp.com, que de toute façon ce langage est sur la pente descendante, qu'il y a plein d'autres sites avec des tutos pour débutants et qu'il y a déjà bien assez à faire si on veut vraiment aborder tout JavaScript, j'ai juste envie de dire poubelle.
+1 comme l'indique mon tout 1er post de ce sujet ;)

Markdown est une bonne idée, le problème restant l'adaptation de l'existant.

[EDIT]
Après avoir envisagé l'option "repartir de zéro" avec du Wordpress + plugins, je pense que ce type de solution ne nous emmènerait pas loin et s'avérerait rapidement bien trop limitée (cf. ce post)

Faire évoluer la "gestion de contenu maison" existante pour supporter à la fois du contenu HTML et Markdown, en s'aidant d'une lib/package externe pour la conversion Markdown => HTML lorsque nécessaire, me semble une option intéressante.

Je pense qu'il nous faudrait un gestionnaire de bugs/features pour suivre tout ça et ne rien oublier. Encore une fois cela donne envie de créer un projet GitHub.
Dans un premier temps, on pourrait même y créer de nouveaux tutos au format Markdown, et récupérer le HTML correspondant en passant par un outil tel que http://dillinger.io.

Re: [Tutos] organisation

Posté : 11 août 2017, 16:06
par Frosty
Dépôt GitHub créé par le webmaster, merci à lui !

Les participations sont donc possibles à quiconque sait faire une "Pull Request", et en Markdown s'il vous plaît.

@QuentinC n'hésites pas à demander l'accès à Olivier pour t'éviter d'avoir à passer par des PR.

Re: [Tutos] organisation

Posté : 18 août 2017, 19:42
par Frosty
@webmaster

Voici un premier jet de tuto pour jQuery (quelques adaptations à prévoir, JSFiddle n'ayant pas permis de faire tout ce que je souhaitais)...

Re: [Tutos] organisation

Posté : 31 août 2017, 14:34
par webmaster
Bonjour,

La mise à jour des tutos avance bien.
Vous pouvez voir le nouveau sommaire ici avec l'état des mises à jour
http://www.toutjavascript.com/savoir/savoir.php3

Les tutos retravaillés ont les exemples intégrés avec :
le code source HTML/JS et éventuellement CSS avec coloration syntaxique (bloc encadré en vert)
le résultat de l'exécution (bloc jaune)
l'affichage de l'émulation de la console (bloc gris)

Re: [Tutos] organisation

Posté : 31 août 2017, 18:23
par Frosty
Super boulot ! ;)

Re: [Tutos] organisation

Posté : 31 août 2017, 18:44
par webmaster
Merci Frosty !

Je suis assez content du résultat

La prochaine étape est de faire un outil de test/debug/partage js/html (type jsfiddle mais plus simple)

Re: [Tutos] organisation

Posté : 31 août 2017, 18:58
par Frosty
Oui un service de jsfiddle simplifié, pourquoi pas. Je vois qu'en ce moment ce genre d'outil (codepad, writephponline...) est assez répandu et utilisé.

Tiens dans ce tuto au statut "révisé", j'ai vu passer quelques "vieilleries" qui ne vont peut-être pas parler à grand monde aujourd'hui : Netscape, applets Java, et même Flash je dirais.

Aussi, vu la chute de popularité de Java depuis une bonne décennie (voir Google trends), la confusion Java/JavaScript me paraît beaucoup moins fréquente et problématique qu'au début des années 2000, du coup je me demande même s'il est pertinent de garder ce tuto (disons en tout cas, dans une version aussi détaillée).

Il faut aussi que je mette à jour le GoogleDoc de suivi de la MàJ des tutos : à part pour les nouvelles idées de tutos je ne vois plus de raison d'y garder le reste de l'arborescence vu que désormais c'est dispo en ligne (y compris le statut "en cours de révision" ou "révisé").
Je vois ça la semaine prochaine dès que j'ai de nouveau accès à mon PC ;)