J’ai passé une petite journée, hier, à modifier tous les fichiers sources (PHP) de :
- Clearbricks
- Dotclear
- De ma dizaine de thèmes perso
- De ma cinquantaine de plugins perso
Pour passer d’un truc qui ressemble à (mais pas toujours, j’ai trouvé des trucs assez différents) :
<?php
# -- BEGIN LICENSE BLOCK ---------------------------------------
#
# This file is part of Dotclear 2.
#
# Copyright (c) 2003-2013 Olivier Meunier & Association Dotclear
# Licensed under the GPL version 2.0 license.
# See LICENSE file or
# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
#
# -- END LICENSE BLOCK -----------------------------------------À un plus exploitable (en tout cas par Doxygen qui permet de générer une documentation à partir des commentaires présents dans les sources) :
<?php
/**
* @package Dotclear
* @subpackage Backend
*
* @copyright Olivier Meunier & Association Dotclear
* @copyright GPL-2.0-only
*/En adaptant bien sur :
- le nom du @package : Dotclear pour Dotclear, les thèmes et les plugins, Clearbricks pour Clearbricks
- Le @subpackage : Core, Admin, Public, Themes, Plugins côté Dotclear, ou plus spécialisé côté Clearbricks
- J’ai rajouté le ou les auteurs si nécessaire (avec une ou plusieurs lignes @author)
- Le @copyright avec les auteurs si besoin ; notez au passage la disparition de la mention de l’année ou des années (une chose de moins à maintenir)
- Tout est passé en GPL-2.0-only côté Clearbricks et Dotclear, mes plugins et thèmes restants en GPL-2.0 ; faut que je vérifie la compatibilité au passage, je ne suis pas sûr que ce soit pertinent
Exemple pour un de mes thèmes :
<?php
/**
* @brief zh2, a theme for Dotclear 2
*
* @package Dotclear
* @subpackage Themes
*
* @copyright Franck Paul (carnet.franck.paul@gmail.com)
* @copyright GPL-2.0
*/Ou encore pour un de mes plugins :
<?php
/**
* @brief hljs, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugins
*
* @author Franck Paul and contributors
*
* @copyright Franck Paul carnet.franck.paul@gmail.com
* @copyright GPL-2.0
*/C’est beaucoup plus clair et carré ainsi.
1 De Cunégonde -
Tu t amuses comme un ptit fou.
2 De Franck -
Oui :-)
3 De Bernard -
in fine, tu vas devenir le seul(*) qui connait les fonds et tréfonds de Dotclear et Clearbricks ;-)
-
(*) saut pitet pour ce qui concerne css and consors ?
4 De Philippe -
@Bernard : même pour les CSS c’est Franck le chef ;) Nous autres, on regarde, on admire et on râle juste de temps en temps pour le garder en forme :D
5 De Franck -
Yup Bernard et tu sais que ce jour est arrivé quand le papa de Dotclear himself me pose une question sur son code, ce qui est arrivé la semaine dernière :-)
6 De Bernard -
Philippe : de mémoire pour tout ce qui concerne l’esthétique, il me semble que c’est madame Koz qui est la chef !
7 De Franck -
Certes Bernard, mais depuis quatre ans y’a plus que moi qui y fiche le souk dans les CSS de mâme Kozlika ;-)