µLua DS - Forum officiel | Official forum Forum Index

µLua DS - Forum officiel | Official forum
Le bon endroit pour en savoir plus sur MicroLua et pour parler de vos projets ! | The right place to learn more about MicroLua and talk about your projects !

 FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister   ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

Doc Microolua

 
Post new topic   Reply to topic    µLua DS - Forum officiel | Official forum Forum Index -> Section française -> Divers -> Autour de µLua
Previous topic :: Next topic  
Author Message
megagugus14


Offline

Joined: 03 Aug 2012
Posts: 168

PostPosted: Wed 2 Jan 2013 - 22:07    Post subject: Doc Microolua Reply with quote

Je me demandais si je pouvais aider pour la doc de Microlua.

Parce que faut dire que la doc qui est livrée en ce moment est... moche Very Happy De plus il faudrait y incorporer :

Arrow Une plus grande accessibilité. Je ne crois pas qu'il est possible d'accéder à tous les fichiers à partir de l'index

Arrow Plusieurs liens plus "frais"

Arrow Une coloration automatique en Javascript des zones de code

Arrow Des titres en français, istoire de trouver son bonheur en étant anglophobe Smile
_________________
Programmeur à 11 ans... Quoi, t'as un problème ?


Back to top
MSN
Publicité






PostPosted: Wed 2 Jan 2013 - 22:07    Post subject: Publicité

PublicitéSupprimer les publicités ?
Back to top
Reylak
Administrateur

Offline

Joined: 24 Nov 2008
Posts: 2,838
Localisation: Toulouse

PostPosted: Thu 3 Jan 2013 - 15:54    Post subject: Doc Microolua Reply with quote

Le fait est que la doc livrée actuellement est une version statique. Ce qui inclut notamment l'absence de mises à jour et la non exhaustivité, parce qu'il me semble inutile d'inclure certaines pages.
Il y a une page sur le Wiki qui parlait de ça un peu : code.google.com/p/microlua/wiki/ReleaseScript#Documentation

Déjà, voilà comment on génère la doc : dans les sources, le dossier docs contient un script Python qui convertit les fichiers .wiki qu'il trouve dans un dossier donné (actuellement, c'est ../../../wiki/$LANG, avec "$LANG" pour gérer toutes les traductions ; c'est un chemin relatif sachant que le script est lancé depuis son dossier) en HTML dans le dossier ../../../HTMLWiki/ (en créant un dossier pour chaque localisation).
En fait, il ne traite que les pages données dans le fichier pages.txt, je considère que celles qui sont là actuellement sont un minimum plutôt correct (ouais il y a pas ApiFourDotSix parce qu'elle était pas encore créée quand j'ai sorti MicroLua 4.6... Un jour je ferai tout dans l'ordre et correctement, mais pas demain =D ).
De plus, il y a un fichier screen.css pour décorer les pages, si tu veux l'améliorer fonce, pour moi c'est trop loin le CSS :p
Pour ce qui est de la coloration, il y a ça dans le script wikify.sh :
Grahack wrote:
# TODO
#######
# override some pages
# try to use the syntax highlighter as in the original template
http://alexgorbatchev.com/wiki/SyntaxHighlighter
#  previously http://code.google.com/p/syntaxhighlighter/


Maintenant que ça c'est fait, pour tes propositions :
  • Donc effectivement, il n'y a pas toutes les pages parce que ça n'est pas utile
  • Pas compris. Si c'est par rapport au contenu, tu peux améliorer le Wiki : http://code.google.com/p/microlua/wiki/HowToContribute
  • Répondu juste au-dessus Surprised
  • Dans le dossier fr, il y a les pages en français, bien que tout ne soit pas traduit (l'API est intégralement traduite)

_________________


Plein d'infos sur le SourceForge !


Back to top
Visit poster’s website MSN Skype
Display posts from previous:   
Post new topic   Reply to topic    µLua DS - Forum officiel | Official forum Forum Index -> Section française -> Divers -> Autour de µLua All times are GMT + 1 Hour
Page 1 of 1

 
Jump to:  

Index | Create a forum | Free support forum | Free forums directory | Report a violation | Cookies | Charte | Conditions générales d'utilisation
Powered by phpBB © 2001, 2005 phpBB Group