La seule modification concerne le controller. En effet, vous pouvez supprimer tout ce qui à trait à la gestion du filtre, soit la classe AdminCheckLogin et l’appel à before_filter :
moduleTestFilter::Controllers # …
class AdminCheckLogin defself.filter( state ) if state[:user].blank? return AdminLogin else returnnil end end end end
A la place de tout cela, vous devez ajouter, ou vous voulez, le code suivant dans votre projet :
module TestFilter
before :AdminHomedo if@state[:user].blank?
redirect R(Controllers::AdminLogin) end end end
Comme vous pouvez le voir, l’appel à before se fait dans le module TestFilter et non dans le controller directement. Il faut donc faire attention lorsque vous faire la redirection !
begin
serial, token = open( PREF ).read.chomp.split( /\|/ ) rescueErrno::ENOENT
serial, token = ["", ""] end
background "nabaztag.png"
stack :margin => 30do
stack :margin => 5do
para "Serial" @serial = edit_line :width => "90%" @serial.text = serial end
stack :margin => 5do
para "Token" @token = edit_line :width => "90%" @token.text = token end
stack :margin => 5do
para "Message" @message = edit_line :width => "90%" end
flow do
stack :width => "20%", :margin => 5do
b = button "Go"do @answer.replace n_say(@serial.text, @token.text, @message.text) if serial != @serial.textor token != @token.text
serial = @serial.text
token = @token.text
write_pref(@serial.text, @token.text) end end end
stack :width => "80%", :margin => 5do @answer = para "" end end end end
Je viens de terminer la première partie de ce qui est certainement la plus grosse documentation que j’ai pu écrire dans ma vie. Je n’en dévoilerai pas plus sur le contenu, car il s’agit d’un travail pour mon employeur, sachez simplement qu’il s’agit d’une documentation d’API à destination de développeurs pour les technologies Windows DLL, Framework MacOSX, .Net, Java et SOAP. Ce qui m’intéresse ici est plutôt de vous parler de la méthode employée.
L’ensemble représente pour le moment 6 documents : 4 Quick Start, un document de référence technique (il en reste 3 à écrire) et un document de cas d’utilisations. Le tout représente plus de 450 pages et nous devrions dépasser les 1600 pages quand les trois derniers documents seront rédigés.
L’ensemble a été écrit en XML ce qui présente l’énorme avantage de pouvoir partager des paragraphes, voir des chapitres, entre plusieurs documents. De plus, l’écriture de cette documentation ce faisant à plusieurs, nous utilisons subversion comme repository de sources, impossible — ou tout au moins inutile — avec un document Word ou OOo. Chacun peut ainsi travailler sur une partie précise de la documentation sans perturber les autres. Nous utilisons CruiseControl.rb pour l’intégration continue.
Nous avons un ensemble de feuilles de styles permettant de générer des versions HTML (une page et multi-pages) et du PDF via FOP.
A l’origine nous utilisions ANT pour générer les documents, mais tout cela est en train de migrer vers Rake. Non seulement l’utilisation de FOPJava avec Ruby est très simple mais en plus cela nous permet de migrer tout un ensemble de scripts sous Ruby/Rake. En effet, nous avons plusieurs scripts pour nous aider. L’un par exemple utilise RubyDiff pour rechercher des différences, entre deux versions d’APIs, et génère automatiquement de nouvelles entrées dans la doc. L’utilisation de REXML nous permet de modifier de la documentation automatiquement, ou de générer de nouvelles pages à partir de templates XML, souvent avec l’aide d’Erb. Tout cela est en train d’être réuni dans un Rakefile. Bien entendu chaque action automatisée est journalisée et peut être rejouée, supprimée, remplacée… Ainsi pour la constitution de la trame du document, chacun peut savoir ce qui a été fait. Cela complété avec les possibilités offertes par SVN fait que nous pouvons à tout moment revoir l’ensemble de l’histoire de la fabrication de cette documentation. Bien entendu la conformité de l’ensemble est validée à chaque étape…
Il est amusant de voir comme nous prenons des habitudes de langage qui vont souvent à notre propre encontre… En effet, combien de fois avons-nous entendu des hackers s’énerver contre la définition donnée par les “médias” de leur titre, les relayant au rang de “méchant” ! Et combien de fois avons-nous entendu ces mêmes hackers vouloir crypter des documents !
Soyons claires, le mot crypter n’existe pas ; en tout cas pas dans la langue française. En effet, si vous voulez transcrire des messages en un langage secret il faut les chiffrer.
Et pourquoi donc Monsieur ? En effet, crypter est (clairement) passé dans le langage courant ! Cependant s’il est préférable de ne pas l’utiliser, c’est surtout à cause de décrypter (qui lui existe). En effet, décrypter consiste à essayer de découvrir un message chiffré, sachant que l’on ignore la méthode de chiffrement. C’est comme forcer une porte !
Donc si vous êtes un hacker, vous chiffrez/déchiffrez ; si vous êtes un pirate, vous chiffrez/décryptez.
