Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
atelier:arborescence [20/09/2013 11:00] smolski [Nouvelle organisation] |
atelier:arborescence [21/09/2013 09:56] kao [Mettre un tuto à sa place] correction liste |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
====== Restructuration du Wiki ====== | ====== Restructuration du Wiki ====== | ||
- | ===== Nouvelle organisation ===== | + | <note info>Ce tuto ne concerne pas les rédacteurs du Wiki, qui doivent eux créer leur tutos dans l'[[:atelier:]] :-)</note> |
- | ==== Grandes lignes ==== | + | Le Wiki est en cours de réorganisation. Voici l'arborescence qui a été retenue et est en train d'être mise en place : |
+ | |||
+ | ===== Grandes lignes ===== | ||
* **Les pages des applications sont triées suivant la section Debian de leur paquet.** | * **Les pages des applications sont triées suivant la section Debian de leur paquet.** | ||
Ligne 9: | Ligne 11: | ||
* **Les noms des sections sont traduits et raccourcis pour ne pas faire des url à rallonge.** | * **Les noms des sections sont traduits et raccourcis pour ne pas faire des url à rallonge.** | ||
- | <note info> | ||
- | Pour identifier de quel paquet vient une application __installée__, on utilise ''dpkg -S //appli//''. | ||
- | Exemple : | + | ===== Arborescence ===== |
- | <code user>dpkg -S ifconfig</code> | + | |
- | ... | + | |
- | net-tools: /sbin/ifconfig | + | |
- | ... | + | |
- | + | ||
- | Nous indique que l'appli ''ifconfig'' est dans le paquet ''net-tools''. | + | |
- | </note> | + | |
- | <note info> | + | |
- | Pour identifier à quelle section appartient un paquet, on utilise ''apt-cache show //paquet// | grep "^Section"''. | + | |
- | + | ||
- | Exemple : | + | |
- | <code user>apt-cache show net-tools | grep "^Section"''</code> | + | |
- | Section: net | + | |
- | La page ''ifconfig'' est donc classée dans '':doc:net:ifconfig''. | + | |
- | + | ||
- | Ou pour un paquet complet, par exemple : | + | |
- | <file user> | + | |
- | apt-cache show dvdauthor | grep "^Section"''</file> | + | |
- | Section: video | + | |
- | + | ||
- | Où l'on voit que que le tuto : **dvdauthor** sera créé dans la page '':doc:video:dvdauthor'' | + | |
- | </note> | + | |
- | + | ||
- | ==== Arborescence ==== | + | |
<note info>les éléments en gras représentent des dossiers</note> | <note info>les éléments en gras représentent des dossiers</note> | ||
Ligne 59: | Ligne 35: | ||
* migrer //Migrer depuis Windows. Tableau d'équivalence GNU/Linux des logiciels// | * migrer //Migrer depuis Windows. Tableau d'équivalence GNU/Linux des logiciels// | ||
* **autres:** | * **autres:** | ||
- | * Miscellaneous //Miscellaneous utilities that didn't fit well anywhere else.// | + | * (misc) Miscellaneous //Miscellaneous utilities that didn't fit well anywhere else.// |
- | * Virtual packages //Virtual packages.// | + | * (virtual) Virtual packages //Virtual packages.// |
* Documentation //FAQs, HOWTOs and other documents trying to explain everything related to Debian, and software needed to browse documentation (man, info, etc).// | * Documentation //FAQs, HOWTOs and other documents trying to explain everything related to Debian, and software needed to browse documentation (man, info, etc).// | ||
* **editeurs:** (Éditeurs de texte, Bureautique, Edit) | * **editeurs:** (Éditeurs de texte, Bureautique, Edit) | ||
- | * Text Processing //Utilities to format and print text documents.// | + | * (text) Text Processing //Utilities to format and print text documents.// |
- | * Editors //Software to edit files. Programming environments.// | + | * (editors) Editors //Software to edit files. Programming environments.// |
* **environnements:** (Environnements de bureau) | * **environnements:** (Environnements de bureau) | ||
- | * Xfce //Xfce, a fast and lightweight Desktop Environment.// | + | * **xfce:** |
- | * KDE //The K Desktop Environment, a powerful, easy to use set of integrated applications.// | + | * (xfce) Xfce //Xfce, a fast and lightweight Desktop Environment.// |
- | * GNOME //The GNOME desktop environment, a powerful, easy to use set of integrated applications.// | + | * **kde:** |
- | * X Window System software //X servers, libraries, fonts, window managers, terminal emulators and many related applications.// | + | * (kde) KDE //The K Desktop Environment, a powerful, easy to use set of integrated applications.// |
+ | * **gnome:** | ||
+ | * (gnome) GNOME //The GNOME desktop environment, a powerful, easy to use set of integrated applications.// | ||
+ | * **x11:** | ||
+ | * (x11) X Window System software //X servers, libraries, fonts, window managers, terminal emulators and many related applications.// | ||
* **electronique:** | * **electronique:** | ||
- | * Electronics //Electronics utilities.// | + | * (electronics) Electronics //Electronics utilities.// |
- | * Embedded software //Software suitable for use in embedded applications.// | + | * (embedded) Embedded software //Software suitable for use in embedded applications.// |
* **install:** (Installation Debian) | * **install:** (Installation Debian) | ||
* Support d'installation | * Support d'installation | ||
Ligne 85: | Ligne 65: | ||
* Installation réseau (PXE) | * Installation réseau (PXE) | ||
* **jeux:** | * **jeux:** | ||
- | * Games //Programs to spend a nice time with after all this setting up.// | + | * (games) Games //Programs to spend a nice time with after all this setting up.// |
* **materiel:** | * **materiel:** | ||
* **imprimantes-scanners:** | * **imprimantes-scanners:** | ||
Ligne 97: | Ligne 77: | ||
* **webcams:** | * **webcams:** | ||
* **media:** (Multimédia & Graphisme) | * **media:** (Multimédia & Graphisme) | ||
- | * Sound //Utilities to deal with sound: mixers, players, recorders, CD players, etc.// | + | * (sound) Sound //Utilities to deal with sound: mixers, players, recorders, CD players, etc.// |
- | * Ham Radio //Software for ham radio.// | + | * (hamradio) Ham Radio //Software for ham radio.// |
- | * Video //Video viewers, editors, recording, streaming.// | + | * (video) Video //Video viewers, editors, recording, streaming.// |
- | * Graphics //Editors, viewers, converters... Everything to become an artist.// | + | * (graphics) Graphics //Editors, viewers, converters... Everything to become an artist.// |
- | * Fonts //Font packages.// | + | * (fonts) Fonts //Font packages.// |
* **programmation:** (Prog, Dev, Développement/Script) | * **programmation:** (Prog, Dev, Développement/Script) | ||
- | * Development //Development utilities, compilers, development environments, libraries, etc.// | + | * (devel) Development //Development utilities, compilers, development environments, libraries, etc.// |
- | * Perl //Everything about Perl, an interpreted scripting language.// | + | * (perl) Perl //Everything about Perl, an interpreted scripting language.// |
- | * PHP //Everything about PHP.// | + | * (php) PHP //Everything about PHP.// |
- | * Python //Everything about Python, an interpreted, interactive object oriented language.// | + | * (python) Python //Everything about Python, an interpreted, interactive object oriented language.// |
- | * Ruby //Everything about Ruby, an interpreted object oriented language.// | + | * (ruby) Ruby //Everything about Ruby, an interpreted object oriented language.// |
- | * Shells //Command shells. Friendly user interfaces for beginners.// | + | * (shells) Shells //Command shells. Friendly user interfaces for beginners.// |
- | * Zope/Plone Framework //Zope Application Server and Plone Content Managment System.// | + | * (zope) Zope/Plone Framework //Zope Application Server and Plone Content Managment System.// |
- | * Library development //Libraries necessary for developers to write programs that use them.// | + | * (libdevel) Library development //Libraries necessary for developers to write programs that use them.// |
- | * Libraries //Libraries to make other programs work. They provide special features to developers.// | + | * (libs) Libraries //Libraries to make other programs work. They provide special features to developers.// |
- | * OCaml //Everything about OCaml, an ML language implementation.// | + | * (ocaml) OCaml //Everything about OCaml, an ML language implementation.// |
- | * Java //Everything about Java.// | + | * (java) Java //Everything about Java.// |
- | * Interpreters //All kind of interpreters for interpreted languages. Macro processors.// | + | * (interpreters) Interpreters //All kind of interpreters for interpreted languages. Macro processors.// |
- | * Haskell //Everything about Haskell.// | + | * (haskell) Haskell //Everything about Haskell.// |
- | * Databases //Database Servers and Clients.// | + | * (database) Databases //Database Servers and Clients.// |
- | * GNUstep //The GNUstep environment.// | + | * (gnustep) GNUstep //The GNUstep environment.// |
- | * Lisp //Everything about Lisp.// | + | * (lisp) Lisp //Everything about Lisp.// |
- | * Mono/CLI //Everything about Mono and the Common Language Infrastructure.// | + | * (cli-mono) Mono/CLI //Everything about Mono and the Common Language Infrastructure.// |
* **reseau:** (Réseaux et Communications) | * **reseau:** (Réseaux et Communications) | ||
- | * Communication Programs //Software to use your modem in the old fashioned style.// | + | * (comm) Communication Programs //Software to use your modem in the old fashioned style.// |
- | * Web Servers //Web servers and their modules.// | + | * (web) Web Servers //Web servers and their modules.// |
- | * Mail //Programs to route, read, and compose E-mail messages.// | + | * (mail) Mail //Programs to route, read, and compose E-mail messages.// |
- | * Network //Daemons and clients to connect your system to the world.// | + | * (net) Network //Daemons and clients to connect your system to the world.// |
- | * Newsgroups //Software to access Usenet, to set up news servers, etc.// | + | * (news) Newsgroups //Software to access Usenet, to set up news servers, etc.// |
* Web Software //Web servers, browsers, proxies, download tools etc.// | * Web Software //Web servers, browsers, proxies, download tools etc.// | ||
* **sciences:** | * **sciences:** | ||
- | * Mathematics //Math software.// | + | * (math) Mathematics //Math software.// |
- | * Science //Basic tools for scientific work// | + | * (science) Science //Basic tools for scientific work// |
- | * TeX //The famous typesetting software and related programs.// | + | * (text) TeX //The famous typesetting software and related programs.// |
- | * GNU R //Everything about GNU R, a statistical computation and graphics system.// | + | * (gnu-r) GNU R //Everything about GNU R, a statistical computation and graphics system.// |
* **systeme:** | * **systeme:** | ||
- | * Administration Utilities //Utilities to administer system resources, manage user accounts, etc.// | + | * (admin) Administration Utilities //Utilities to administer system resources, manage user accounts, etc.// |
* debian-installer udeb packages //Special packages for building customized debian-installer variants. Do not install them on a normal system!// | * debian-installer udeb packages //Special packages for building customized debian-installer variants. Do not install them on a normal system!// | ||
- | * Debug packages //Packages providing debugging information for executables and shared libraries.// | + | * (debug) Debug packages //Packages providing debugging information for executables and shared libraries.// |
- | * Kernels //Operating System Kernels and related modules.// | + | * (kernel) Kernels //Operating System Kernels and related modules.// |
- | * Utilities //Utilities for file/disk manipulation, backup and archive tools, system monitoring, input systems, etc.// | + | * (utils) Utilities //Utilities for file/disk manipulation, backup and archive tools, system monitoring, input systems, etc.// |
- | * Version Control Systems //Version control systems and related utilities.// | + | * (vcs) Version Control Systems //Version control systems and related utilities.// |
- | * Old Libraries //Old versions of libraries, kept for backward compatibility with old applications.// | + | * (oldlibs) Old Libraries //Old versions of libraries, kept for backward compatibility with old applications.// |
- | * Other OS's and file systems //Software to run programs compiled for other operating systems, and to use their filesystems.// | + | * (otherosfs) Other OS's and file systems //Software to run programs compiled for other operating systems, and to use their filesystems.// |
* Language packs //Localization support for big software packages.// | * Language packs //Localization support for big software packages.// | ||
* **:man:** (dossier contenant les man en français, généré automatiquement) | * **:man:** (dossier contenant les man en français, généré automatiquement) | ||
Ligne 146: | Ligne 126: | ||
* **:utilisateurs:** //Dossier contenant les pages créées par les utilisateurs.// | * **:utilisateurs:** //Dossier contenant les pages créées par les utilisateurs.// | ||
* **captnfab:** | * **captnfab:** | ||
+ | |||
+ | ===== Mettre un tuto à sa place ==== | ||
+ | |||
+ | <note info>Ce paragraphe s'adresse principalement aux modérateurs, seuls habilités à déplacer les tutos (et encore, pas encore :-P).</note> | ||
+ | |||
+ | ==== Identifier le paquet ==== | ||
+ | |||
+ | Pour identifier de quel paquet vient une application __installée__, on utilise ''dpkg -S //appli//''. | ||
+ | |||
+ | Exemple : | ||
+ | <code user>dpkg -S ifconfig</code> | ||
+ | ... | ||
+ | net-tools: /sbin/ifconfig | ||
+ | ... | ||
+ | |||
+ | Nous indique que l'appli ''ifconfig'' est dans le paquet ''net-tools''. | ||
+ | |||
+ | Pour une application qui n'est pas installée, il faudra utiliser ''apt-file''. | ||
+ | |||
+ | ==== Identifier la section ==== | ||
+ | |||
+ | Pour identifier à quelle section appartient un paquet, on utilise ''apt-cache show //paquet// | grep "^Section"''. | ||
+ | |||
+ | Exemple : | ||
+ | <code user>apt-cache show net-tools | grep "^Section"''</code> | ||
+ | Section: net | ||
+ | La page ''ifconfig'' est donc classée dans '':doc:net:ifconfig''. | ||
+ | |||
+ | ==== Exemple ==== | ||
+ | |||
+ | Ou pour une application, par exemple ''dvdauthor'' : | ||
+ | <file user> | ||
+ | apt-cache show dvdauthor | grep "^Section"''</file> | ||
+ | Section: video | ||
+ | |||
+ | Où l'on voit que que le tuto : **dvdauthor** sera créé dans la page '':doc:media:video:dvdauthor'' | ||
+ | |||
+ | ==== Automatisation ==== | ||
+ | |||
+ | Voici un script tentant d'automatiser la détection de la nouvelle adresse en fonction du nom de la page : | ||
+ | <code bash guess-new-path.sh>#!/bin/bash | ||
+ | set -e | ||
+ | set -x | ||
+ | set -u | ||
+ | |||
+ | APP=$1 | ||
+ | |||
+ | PACKAGE=$(apt-cache search -n '^'"$APP"'$' |cut -f1 -d' ') | ||
+ | |||
+ | if [ -z "$PACKAGE" ]; | ||
+ | then | ||
+ | PACKAGE=$(apt-file search -F -l "/usr/bin/$APP") | ||
+ | fi | ||
+ | |||
+ | if [ -z "$PACKAGE" ]; | ||
+ | then | ||
+ | PACKAGE=$(apt-file search -F -l "/bin/$APP") | ||
+ | fi | ||
+ | |||
+ | if [ -z "$PACKAGE" ]; | ||
+ | then | ||
+ | PACKAGE=$(apt-file search -F -l "/sbin/$APP") | ||
+ | fi | ||
+ | |||
+ | if [ -z "$PACKAGE" ]; | ||
+ | then | ||
+ | PACKAGE=$(apt-file search -F -l "/usr/sbin/$APP") | ||
+ | fi | ||
+ | |||
+ | if [ -z "$PACKAGE" ]; | ||
+ | then | ||
+ | echo "Paquet non-trouvé" | ||
+ | exit 1 | ||
+ | fi | ||
+ | |||
+ | SECTION=$(apt-cache show $PACKAGE | sed -n '/^Section/s/^Section: //p') | ||
+ | |||
+ | declare -A paths | ||
+ | |||
+ | paths["unknown"]="doc:autres" | ||
+ | paths["virtual"]="doc:autres" | ||
+ | paths["admin"]="doc:systeme" | ||
+ | paths["alien"]="doc:systeme" | ||
+ | paths["base"]="doc:programmation" | ||
+ | paths["cli-mono"]="doc:programmation" | ||
+ | paths["comm"]="doc:reseau" | ||
+ | paths["database"]="doc:programmation" | ||
+ | paths["debug"]="doc:systeme" | ||
+ | paths["devel"]="doc:programmation" | ||
+ | paths["editors"]="doc:editeurs" | ||
+ | paths["electronics"]="doc:electronique" | ||
+ | paths["embedded"]="doc:electronique" | ||
+ | paths["fonts"]="doc:media" | ||
+ | paths["games"]="doc:jeux" | ||
+ | paths["gnome"]="doc:environnements:gnome" | ||
+ | paths["gnu-r"]="doc:sciences" | ||
+ | paths["gnustep"]="doc:programmation" | ||
+ | paths["graphics"]="doc:media" | ||
+ | paths["hamradio"]="doc:media" | ||
+ | paths["haskell"]="doc:programmation" | ||
+ | paths["httpd"]="doc:reseau" | ||
+ | paths["interpreters"]="doc:programmation" | ||
+ | paths["java"]="doc:programmation" | ||
+ | paths["kernel"]="doc:systeme" | ||
+ | paths["kde"]="doc:environnements:kde" | ||
+ | paths["libdevel"]="doc:programmation" | ||
+ | paths["libs"]="doc:programmation" | ||
+ | paths["lisp"]="doc:programmation" | ||
+ | paths["localization"]="doc:systeme" | ||
+ | paths["mail"]="doc:reseau" | ||
+ | paths["math"]="doc:sciences" | ||
+ | paths["misc"]="doc:autres" | ||
+ | paths["net"]="doc:reseau" | ||
+ | paths["news"]="doc:reseau" | ||
+ | paths["ocaml"]="doc:programmation" | ||
+ | paths["oldlibs"]="doc:systeme" | ||
+ | paths["otherosfs"]="doc:systeme" | ||
+ | paths["perl"]="doc:programmation" | ||
+ | paths["php"]="doc:programmation" | ||
+ | paths["python"]="doc:programmation" | ||
+ | paths["ruby"]="doc:programmation" | ||
+ | paths["science"]="doc:sciences" | ||
+ | paths["shells"]="doc:programmation" | ||
+ | paths["sound"]="doc:media" | ||
+ | paths["tex"]="doc:sciences" | ||
+ | paths["text"]="doc:editeurs" | ||
+ | paths["utils"]="doc:systeme" | ||
+ | paths["video"]="doc:media" | ||
+ | paths["vcs"]="doc:systeme" | ||
+ | paths["web"]="doc:reseau" | ||
+ | paths["x11"]="doc:environnements:x11" | ||
+ | paths["xfce"]="doc:environnements:xfce" | ||
+ | paths["zope"]="doc:programmation" | ||
+ | |||
+ | |||
+ | |||
+ | NEWPATH=${paths[${SECTION}]}":"$APP | ||
+ | |||
+ | echo "Page=$APP Paquet=$PACKAGE Section=$SECTION NouveauNom=$NEWPATH"</code> |