Je confirme. Ce fichier est assez central, il implémente une bonne partie de la spec epub3 fixed layouts. Il peut être assez tentant de venir modifier des choses dans ce fichier pour implémenter certains fonctionnalités en prenant un raccourci. Mais c'est une fausse bonne idée, on se retrouve vite avec plein de cas particuliers qui ne fonctionnent plus. La spec epub3 fixed layout a été écrite par des gens qui ne sont pas forcément super techniques (elle a été poussée par les gens qui créent les contenus, pas ceux qui s'occupent des outils autour des epub, et ça s'en ressent). Du coup, le commentaire sert à prévenir les futurs contributeurs que n'importe quelle modification dans ce fichier prendra plus de temps que ce que l'on pourrait croire et qu'il faudra souvent beaucoup de courage pour chasser les bugs sur des cas très particuliers.
[^] # Re: Oh, le joli commentaire !
Posté par Bruno Michel (site web personnel) . En réponse au sondage Les commentaires et vous ?. Évalué à 7.
Je confirme. Ce fichier est assez central, il implémente une bonne partie de la spec epub3 fixed layouts. Il peut être assez tentant de venir modifier des choses dans ce fichier pour implémenter certains fonctionnalités en prenant un raccourci. Mais c'est une fausse bonne idée, on se retrouve vite avec plein de cas particuliers qui ne fonctionnent plus. La spec epub3 fixed layout a été écrite par des gens qui ne sont pas forcément super techniques (elle a été poussée par les gens qui créent les contenus, pas ceux qui s'occupent des outils autour des epub, et ça s'en ressent). Du coup, le commentaire sert à prévenir les futurs contributeurs que n'importe quelle modification dans ce fichier prendra plus de temps que ce que l'on pourrait croire et qu'il faudra souvent beaucoup de courage pour chasser les bugs sur des cas très particuliers.