Shell command projects/mkd

De Wiki EELL.

(Différences entre les versions)
m (Handbuch in German : Mise à jour)
m (Mise à jour des traductions / Update translations : Mise à jour)
 
(61 versions intermédiaires masquées)
Ligne 12 : Ligne 12 :
-->
-->
[[Fichier:Ubuntu.png|thumb|50px|Ubuntu]][[Fichier:200px-Openlogo-debianV2.png|thumb|50px|Debian]][[Fichier:Fedora logo.png|thumb|50px|Fedora]]
[[Fichier:Ubuntu.png|thumb|50px|Ubuntu]][[Fichier:200px-Openlogo-debianV2.png|thumb|50px|Debian]][[Fichier:Fedora logo.png|thumb|50px|Fedora]]
-
↑ <small>[[Portail:mkd|Retour au portail mkd]]</small><br/>  
+
↑ <small>[[Portail:mkd|Retour au portail mkd]]</small><br/>
-
Cette page n'est pas encore opérationnelle. L'empaquetage n'est pas prévue avant juillet 2012.
+
-
La version console (terminal) non empaquetée est disponible: [[Projet_mkd/t%C3%A9l%C3%A9chargements/UNIX_LINUX]]
+
-
== Captures d'écran / Screenshot ==
+
See also [[Projet_mkd/t%C3%A9l%C3%A9chargements/UNIX_LINUX]] Beta and unstable versions.
-
== Téléchargements de paquets / Downloads local packages ==
+
<!--== Téléchargements de paquets / Downloads '''local''' packages ==
-
Index of [http://edeulo.free.fr/pub/mkd/dist/ mkd local package distribution]
+
-
== Distributions Ubuntu / Update packages ==
 
-
[https://launchpad.net/~jean-paul-louyot/+archive/mkd launchpad.net +archive/mkd]
 
-
dist bin deb https://launchpad.net/~jean-paul-louyot/+archive/mkd/+packages ubuntu 12.04 (precise)
+
{{Modèle:Méta-bandeau
-
<u>Mettre votre liste des paquets à jour (systèmes d'expoitation plus anciens) :</u>
+
|titre=''' ATTENTION'''
-
deb http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu precise main
+
|background=#fafafa
-
deb-src http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu precise main
+
|border-left=red
 +
|''' Les modifications sur les serveur de ''free.fr'' interdisent la lecture des répertoires. (Liens se terminant par le caractère '/')'''
-
<u>Pour les nouveaux systèmes ubuntu 12.04 (precise) l'utilitaire '''deb''' n'existe plus.</u>
+
''Ces liens sont en cours de révision ... Merci de votre compréhension''
 +
}}
-
Pour mettre votre liste à jour, utilisez : '''sudo add-apt-repository ppa:jean-paul-louyot/mkd'''
+
; Packages :Debian/Ubuntu :
 +
; Index of [http://edeulo.free.fr/pub/mkd/ '''mkd local deb packages''', ''dist, doc and translations''] for :
 +
:* '''mkd''' : Downloads ''updates for 32 bits (x86), and 64 bits (amd64) processors'' (de) (en) (fr) last update '''2014-05-15'''
-
Pour récupérer les fichiers source : '''apt-get source mkd'''
+
:* '''mkddocu''' : Download ''update for all (x86 and amd64 processors)'' (en) (fr) last update '''mkddocu_140515_all.deb'''
-
== Manuels / Manuals ==
+
:* '''Translations''': Download mkd_0~130514.lang.tar.gz (de) (en) (fr) for all versions 2012 to 2014. Updated the '''2013-05-14'''
-
*(man1) :  
+
-
: - Téléchargez la mise à jour des manuels:
+
-
: - Download the latest manual multi-lang Installer:
+
-
:: <strike>[http://edeulo.free.fr/telechargements/console-ubuntu/mkd/mkd_manuals_2012-11-06.tgz <big>'''mkd manuals 2012-11-06'''</big>]</strike> (en) (de) (fr) (Obsolète)
+
-
*'''Attention :''' Vérifiez les dates de publication de ces pages de manuels ci-dessous en bas de page.  
+
;Sources : Original files '''for all linux systems''' Debian, Ubuntu, Fedora, etc. :
-
=== Manual in english ===
+
:* Index of [http://edeulo.free.fr/pub/downloads_sources/ '''mkd local source files'''] Last update '''2014-05-15'''
 +
-->
 +
 
 +
== Distributions Ubuntu / Update packages on '''launchpad'''.net ==
 +
<!--'''MISE À JOUR EN COURS'''-->
 +
 
 +
; {{violet|Dernières versions à jour mkd - 140315 Saucy, 140515 Trusty et 140515 Utopic.}}<br>
 +
'''''mkd 140515''' is updated for Trusty (Ubuntu 14.04) and Utopic (Ubuntu 14.10) and '''is available for Ubuntu Vivid (15.04)'''''<br/>
 +
Télécharger le fichier .deb correspondant à votre processeur puis cliquez deux fois sur le fichier téléchargé pour l'installer.
 +
: [https://launchpad.net/~jean-paul-louyot/+archive/mkd '''Adding this PPA to your system''']
 +
 
 +
: [https://launchpad.net/~jean-paul-louyot/+archive/mkd/+copy-packages '''Téléchargements ''(sources et binaires)'' de la dernière version''']
 +
 
 +
=== Mettre votre liste des paquets à jour ===
 +
 
 +
: deb http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu <version ubuntu> main
 +
 
 +
: deb-src http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu <version ubuntu> main
 +
 
 +
; En cas d'échec avec deb :
 +
 
 +
: Pour les mises à jour automatiques : '''sudo add-apt-repository ppa:jean-paul-louyot/mkd'''
 +
 
 +
: Pour récupérer les fichiers source : '''apt-get source mkd''' ''après installation des mises à jour automatiques.''
 +
 
 +
=== Convertir les paquets Debian ===
 +
 
 +
: '''Alien''' convertit les paquets deb dans les formats rpm, dpkg, stampede slp, et slackware tgz
 +
 
 +
: [http://joeyh.name/code/alien/ '''Site officiel Alien'''] ; [http://www.rpmfind.net/linux/rpm2html/search.php?query=alien '''Télécharger le logiciel Alien''']
 +
 
 +
=== Convertir un paquet .deb en .rpm ===
 +
 
 +
Commande suggérée :
 +
 
 +
sudo alien -r mkd-doc_140515_all.deb
 +
 
 +
; Installation des paquets rpm convertis avec Alien :
 +
 
 +
Il peut y avoir un conflit entre les systèmes de fichiers avec la commande yum. Utiliser la commande rpm :
 +
 
 +
Exemple :
 +
sudo rpm -ivh mkd-doc-140515-2.noarch.rpm --force
 +
 
 +
== Distributions de mkd en paquets Debian, RPM, Windows ==
 +
 
 +
 
 +
''Certains paquets sont convertis avec Alien d'autres sont mis en paquets avec Fedora 23''
 +
 
 +
: 2018-09-19 Téléchargements sur la [http://91.162.11.71:39686 Disk station EELL]
 +
 
 +
== Manuels / Manuals mkd ==
 +
; (man1) (man3) 
 +
: - Téléchargez a mise à jour des manuels incluse dans les fichiers de [http://edeulo.free.fr/pub/mkd/ '''translations''']
 +
 
 +
=== Manual mkd in english ===
<!--PRE STYLE="font-family:monospace;
<!--PRE STYLE="font-family:monospace;
font-size:0.95em;
font-size:0.95em;
Ligne 55 : Ligne 105 :
This is red
This is red
</PRE-->
</PRE-->
-
{{Boîte déroulante/début|titre=Manual en (April 6, 2013)}}
+
{{Boîte déroulante/début|titre=mkd Manual en (May 11, 2013)}}
<pre style="color:white;
<pre style="color:white;
background-color:black;">
background-color:black;">
-
 
+
MKD(1)                                                                 MKD(1)
-
MKD(1)                                                                 MKD(1)
+
NAME
NAME
-
       mkd  -  make documentation.  Extract coded informations from programs
+
       mkd  -  make documentation.  Extract coded informations from programs
       sources and product specific documentation.
       sources and product specific documentation.
Ligne 71 : Ligne 120 :
DESCRIPTION
DESCRIPTION
-
       mkd
+
       mkd   Selected comments (or all comments) are extracted from  programs
-
              Selected comments (or all comments) are extracted from  pro‐
+
               sources and product specific documentation to target file. Usual
-
               grams  sources and product specific documentation to target
+
              target files are Organigrams, or Structure of programs, or com‐
-
              file. Usual target files are Organigrams, or Structure of  pro‐
+
               ments for Programmers, Warnings and Tests points .... Coded
-
               grams, or comments for Programmers, Warnings and Tests points
+
              informations are respectively 'O', 'S', 'P', 'www', ant 'T' just
-
              .... Coded informations are respectively 'O', 'S', 'P', 'www',
+
              after the comment character.
-
              ant 'T' just after the comment character.
+
       char_codes
       char_codes
-
               All  ASCII. The comment are extracted if the comment begin with
+
               All  ASCII. The comment are extracted if the comment begin with
               this character. With two star mkd extract all comments.
               this character. With two star mkd extract all comments.
Ligne 87 : Ligne 135 :
       path_target
       path_target
-
               Path target file. Default, path target is idendical  to  source
+
               Path target file. Default, path target is idendical  to  source
               file with extension ´.doc´ .
               file with extension ´.doc´ .
Ligne 110 : Ligne 158 :
       -a    append to current target file.
       -a    append to current target file.
-
       -f    find source file language. (useful with project file)
+
       -f    find source file language. (useful with project file). mkd rec‐
 +
              ognizes the following files: .asm, .s; .bas, .vb, .bat; .C,  .H,
 +
              .D,  .cc,  .hh,  .cp, .cs, c#, .c++, .h++, c--, h--, .cpp, .hpp,
 +
              .css, .pr, .pl, .php, .jav, .jse .js; .for, .f; .pas,  .p;  .sh,
 +
              .csh , .pl, .rb, .py, .pyw; .pj, .prj
       -j    used if source file is a project file.
       -j    used if source file is a project file.
-
       -l    lines (extract lines delimited by CD1 or CD2 in first colomn or
+
       -l    lines (extract lines delimited by CD1 or CD2 in first colomn or
-
               CD3 in line, and next New-Line. CD1, CD2,  CD3  are  compilable
+
               CD3 in line, and next New-Line. CD1, CD2,  CD3  are  compilable
-
               options  in version.h from mkd distribution). You can see these
+
               options  in version.h from mkd distribution). You can see these
               options compiled by the command mkd \?
               options compiled by the command mkd \?
       -n    numbering the lines (line number from source files)
       -n    numbering the lines (line number from source files)
-
       -p    page (extract text delimited by CD4 and CD5 -begin with CD4 and
+
       -p    page (extract text delimited by CD4 and CD5 -begin with CD4 and
-
               end with CD5-. CD4, CD5 are compilable options in version.h
+
               end with CD5-. CD4, CD5 are compilable options in version.h from
-
               from mkd distribution). You can see these options  compiled  by
+
               mkd distribution). You can see these options  compiled  by the
-
               the command mkd \?
+
               command mkd \?
       -s    add to screen. (verbose)
       -s    add to screen. (verbose)
Ligne 142 : Ligne 194 :
       mkd -Csl '*Sied' mkd3.c  '*.verif_struct'
       mkd -Csl '*Sied' mkd3.c  '*.verif_struct'
-
               Product  documentation  with  structure  of  program, includes,
+
               Product  documentation  with  structure  of  program, includes,
-
               defines, ifdef else and endif compile options, to verify struc‐
+
               defines, ifdef else and endif compile options, to verify struc‐
-
               ture of program.  (with compilable options CD1='#' or CD2='#'
+
               ture of program.  (with compilable options CD1='#' or CD2='#' in
-
               in version.h from mkd distribution).
+
               version.h from mkd distribution).
       mkd -jfsl '*OHie' mkd_docu.prj mkd.org
       mkd -jfsl '*OHie' mkd_docu.prj mkd.org
-
               Product organigram. Comment begin with *,O,H, and sources files
+
               Product organigram. Comment begin with *,O,H, and sources files
-
               are listed in project file.  (with compilable options CD1='#'
+
               are listed in project file.  (with compilable options CD1='#' or
-
               or CD2='#'). f: find language, j: source file is a project file
+
               CD2='#'). f: find language, j: source file is a project file
               containing the list of sources files.
               containing the list of sources files.
       mkd -l '*ide' mkd3.c '*.id_ei'
       mkd -l '*ide' mkd3.c '*.id_ei'
-
               (with  compilable  options  CD1='#'  or CD2='#', extract lines:
+
               (with  compilable  options  CD1='#'  or CD2='#', extract lines:
               #include, #define, #ifdef, #else, #endif, etc.)
               #include, #define, #ifdef, #else, #endif, etc.)
       mkd -pj '**' mkd_docu.prj mkd.strings
       mkd -pj '**' mkd_docu.prj mkd.strings
-
               Extract strings from program. (messages are printed to stdout).
+
               Extract strings from program. (messages are printed to stdout).
-
               (sources files are itemize in project file, and with compilable
+
               (sources files are itemize in project file, and with compilable
               options CD4=CD5=´\"´).
               options CD4=CD5=´\"´).
       mkd (without argument)
       mkd (without argument)
-
               Cause any error and syntax are transmit to terminal with carac‐
+
               Cause any error and syntax are transmit to terminal with carac‐
               ters compiled to use options l and p.
               ters compiled to use options l and p.
Ligne 170 : Ligne 222 :
HISTORY
HISTORY
-
       1986 - mkd for DOS, and mkdoc for UNIX, are writen  in  ASCII format
+
       1986 - mkd for DOS, and mkdoc for UNIX, are writen  in  ASCII format by
-
       by Jean-Paul Louyot for the Montpellier Universidad  'CEM'  laboratory
+
       Jean-Paul Louyot for the Montpellier Universidad  'CEM'  laboratory
       (France).
       (France).
       1991 - mkdoc 3.12 for PC and UNIX (Sun)
       1991 - mkdoc 3.12 for PC and UNIX (Sun)
-
       1995 - 2004 - mkdoc 3.22 to mkdoc 4 for Unix and Linux: SUN-SPARC, HP-
+
       1995 - 2004 - mkdoc 3.22 to mkdoc 4 for Unix and Linux: SUN-SPARC, HP-
       UX, RedHat
       UX, RedHat
       2004 - mkdoc 4 for Linux Ubuntu, Windows 98, Windows 2000
       2004 - mkdoc 4 for Linux Ubuntu, Windows 98, Windows 2000
-
       2007-2012 - mkdoc release 7.01 to mkd R12.01 are   in   format
+
       2007-2012 - mkdoc release 7.01 to mkd R12.01 are in format ISO-8859-1.
-
      ISO-8859-1. The name 'mkdoc' is  abandoned with the  release  10.01
+
      The name 'mkdoc' is  abandoned with the  release  10.01 compiled  with
-
      compiled  with Visual C++ 2010
+
      Visual C++ 2010
-
       2012 - mkd 12.03 is  adapted  to   UTF-8   format   for   translations
+
       2012 - mkd 12.03 is  adapted  to UTF-8 format for translations and
-
       and  internationalization. In the wake mkdcppw is writen to decode
+
       internationalization. In the wake mkdcppw is writen to decode computer
-
       computer C, c++ and php languages in graphical mode with 'gcc' and
+
       C, c++ and php languages in graphical mode with 'gcc' and 'gtkmm'.
-
      'gtkmm'.
+
DOWNLOADS
DOWNLOADS
-
       http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-
+
       http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
-
      LINUX
+
AUTHORS
AUTHORS
Ligne 211 : Ligne 261 :
NOTES
NOTES
-
       It belong to the programmers to close comments, blocks and  lines,  by
+
       It belong to the programmers to close comments, blocks and  lines,  by
       the appropriate closing codes in the source files.
       the appropriate closing codes in the source files.
-
       Warning:  The  closure of a comment line is a carriage-return (NL, LF,
+
       Warning:  The  closure of a comment line is a carriage-return (NL, LF,
       CR/LF) as the case.
       CR/LF) as the case.
-
       At the end of the file: this note implies a carriage-return at the end
+
       At the end of the file: this note implies a carriage-return at the end
-
       of the comment line. In this case you must have a blank line at the
+
       of the comment line. In this case you must have a blank line at the end
-
       end of the source file.
+
       of the source file.
-
       Do es not allow to read and decode the files included by  #include  in
+
       Do es not allow to read and decode the files included by  #include  in
       the sources files.
       the sources files.
Ligne 232 : Ligne 282 :
-
                                April 6, 2013                         MKD(1)
+
                                May 11, 2013                           MKD(1)
</pre>
</pre>
{{Boîte déroulante/fin}}
{{Boîte déroulante/fin}}
-
=== Manuel en français ===
+
=== Manual mkd en español ===
-
{{Boîte déroulante/début|titre=Manuel fr (6 Avril 2013)}}
+
{{Boîte déroulante/début|titre=mkd Manual es (11 Mai 2013)}}
 +
<pre style="color:white;background-color:black;">
 +
MKD(1)                      Manual de usario Unix                      MKD(1)
 +
 
 +
 
 +
 
 +
                Ultima actualizado hace 3 de octubre de, 2017
 +
 
 +
NOMBRE
 +
      mkd  - make documentation. Generar (agregar) documentación. El programa
 +
      extrae la información codificada de los programas fuentes, y produce la
 +
      documentación especifica.
 +
 
 +
SINOPSIS
 +
      mkd [-ABCFPSafjlpstw] codigos ruta-de_origen [ruta-destino]
 +
 
 +
DESCRIPCIÓN
 +
      mkd    Los  comentarios  seleccionados  (o  todos  los comentarios) son
 +
              extraidos de los programas fuente ‘ruta-de_origen’ y son  copia‐
 +
              dos en un fichero documental : ‘ruta-destino’, a fin de producir
 +
              una documentacion especifica. Por  norma  general  los  ficheros
 +
              documentales  sont organigramas, estructuras de programa, comen‐
 +
              tarios para programadores, puntos de  test  y  ‘alertas’  (warn‐
 +
              ings)…  Los  codigos  a  seleccionar pueden ser los siguientes :
 +
              ‘O’, ‘S’,’P’,’T’ y ‘www’ justo despues del caracter delimitador.
 +
 
 +
      codigos
 +
              Los comentarios que empiezen por estos caracteres son  extraidos
 +
              del  programa fuente y son anadidos al fichero documental. Todos
 +
              los caracteres ASCII pueden servir para codificar los  comentar‐
 +
              ios,  no  obstante se suelen utilizar caracteres con mayusculas,
 +
              excepto W para ‘warning’. Con dos astericos en  parametro  codi‐
 +
              gos,  mkd  etrae  todos los comentarios. (ver tambien opcion t y
 +
              los ejamplos)
 +
 
 +
      ruta-de_origen
 +
              Ruta del archivo de fuente (o archive(fichero) proyecto:  opción
 +
              j).
 +
 
 +
      ruta-destino
 +
              Ruta  del  fichero  documental.  Por defecto ruta-destino es una
 +
              copia de ruta de origen al cual anadimos el sufijo por el sufijo
 +
              ‘doc’
 +
 
 +
OPCIONES
 +
      Opciones de mayúsculas:
 +
              Limita  la extraccion de los comentarios a un estilo de lenguaje
 +
              específico:
 +
 
 +
      -A    Extrae comentarios de estilo  ensamblador  (;  al  final  de  la
 +
              línea)
 +
 
 +
      -B    Estilo basico              (REM o ' → final de la línea)
 +
 
 +
      -C    Estilo C ++                ( // → NL y  /*  →  */ )
 +
 
 +
      -F    Estilo Fortran              (c, C o * → final de la línea)
 +
 
 +
      -P    Estilo -P Pascal            ( {  →  } y (*  →  *)  )
 +
 
 +
      -S    Shell o estilo Ratfor      ( #  →  final de la línea)
 +
 
 +
      Lowercase options:
 +
 
 +
      -a    (append) Anade despues del fichero documental ruta destino.
 +
 
 +
      -f    (find)  Encuentra un lenguaje del fichero fuente con el analisis
 +
              del sufijo. (útil con el archivo de proyecto). mkd reconoce  los
 +
              siguientes  archivos:  .asm,  .s;  .bas, .vb, .bat;  .C, .H, .D,
 +
              .cc, .hh, .cp, .cs, C #, .c ++, .h  ++,  c--,  H-,  .cpp,  .hpp,
 +
              .css,  .pr,  .pl,  .php,  .jav, .js .JSE;  .para, .f;  .pas, .p;
 +
              .sh, .csh, .pl, .rb, .py, .pyw;  .pj, .prj
 +
 
 +
      -j    (project) Se  utiliza  con  un  fichero  proyecto  compuesto  de
 +
              fuentes de lenguajes diferentes.
 +
 
 +
      -l    (lines)  Extrae las lineas que empiezan por los caracteres CD1 o
 +
              CD2 o CD3 y seguidos por caracteres codigos,  el  comentario  se
 +
              acaba por la lectura del caracter ‘linea nueva’. CD1 y CD2 deben
 +
              estar en le primera columna, en vez de CD3  puede  estar  en  el
 +
              medio de la linea. CD1, CD2, CD3, son opciones compilables en el
 +
              fichero version.h de la distribucion de origen de mkd. Se pueden
 +
              conocer estas opciones compiladas por mkd \?
 +
 
 +
      -n    (num) Enumera las líneas (número de línea del archivo fuente)
 +
 
 +
      -p    (page)  Extrae  el texto que empieze por el caracter CD4 seguido
 +
              de uno de los caracteres de codigos. La  extraccion  del  comen‐
 +
              tario  se  acaba  con la lectura del caracter CD5. CD4 y CD5 son
 +
              opciones compiladas en el fichero version.h de  la  distribucion
 +
              de  origen  de  MKD. Se pueden conocer estas opciones compiladas
 +
              por mkd \?
 +
 
 +
      -s    (screen, verbose) Duplica los comentarios extraidos en la salida
 +
 
 +
      -t    (text) Solamente copia en comentario
 +
 
 +
      -w    (overwrite) Escribe de nuevo el fichero documental.
 +
 
 +
EJEMPLOS
 +
      con el comando shell:
 +
 
 +
      mkd -Ct F manual mkd.1 | gzip -f mkd.1.gz
 +
              Producto manual de UNIX para los usuarios franceses.
 +
 
 +
      mkd -Ct M manual mkd.1 | gzip -f mkd.1.gz
 +
              Manual de UNIX del producto.
 +
 
 +
      mkd -Csl '*Sied' mkd3.c  '*.verif_struct'
 +
              Documentación del  producto  con  la  estructura  del  programa,
 +
              incluye,  define,  ifdef  cosa  y endif opciones de compilación,
 +
              para verificar estructura del programa.  (con  opciones  compil‐
 +
              ables CD1 = '#' o CD2 = '#' en version.h de distribución mkd).
 +
 
 +
      mkd -jfsl '*OHie' mkd_docu.prj mkd.org
 +
              Organigrama del producto. Comentarios empezar *, O, H y archivos
 +
              de fuentes se enumeran en el archivo de proyecto.  (con opciones
 +
              compilables  CD1  = '#' o CD2 = '#').  f: encontrar un lenguaje,
 +
              j: archivo de origen es un archivo de proyecto que  contiene  la
 +
              lista de archivos de fuentes.
 +
 
 +
      mkd -l '*ide' mkd3.c '*.id_ei'
 +
              (con  opciones  compilables  CD1  =  '#'  o CD2 = '#', líneas de
 +
              extracto: #include, #define, #ifdef, #else, #endif, etc.)
 +
 
 +
      mkd -pj '**' mkd_docu.prj mkd.strings
 +
              Extraer cadenas de programa.  (mensajes se imprimen en  stdout).
 +
              (archivos  de fuentes están detallar en el archivo de proyecto y
 +
              con compilable Opciones  CD4=CD5=´\"´).  Extract  strings  from
 +
              program.  (messages  are printed to stdout).  (sources files are
 +
              itemize  in  project  file,  and  with  compilable  options
 +
              CD4=CD5=´\"´).
 +
 
 +
      mkd (sin argumento)
 +
              Causa  cualquier  error  y la sintaxis se transmiten al terminal
 +
              con los caracteres compilados para utilizar opciones l y p.
 +
 
 +
VER TAMBIÉN
 +
      mkdcppw(1)
 +
 
 +
HISTORIA
 +
      1986 - MKD para DOS y mkdoc para UNIX,  se  Escrito  en  formato  ASCII
 +
      Jean-Paul  Louyot  para el laboratorio de la Universidad de Montpellier
 +
      "CEM" (Francia).
 +
 
 +
      1991 - mkdoc 3.12 para PC y UNIX (Sun)
 +
 
 +
      1995 - 2004 - mkdoc 3.22 a mkdoc 4 para Unix y Linux: SUN-SPARC, HP-UX,
 +
      RedHat
 +
 
 +
      2004 - mkdoc 4 para Linux Ubuntu, Windows 98, Windows 2000
 +
 
 +
      2007-2012  -  mkdoc  versión  7.01  para  MKD  R12.01  están en formato
 +
      ISO-8859-1. El nombre 'mkdoc' se abandona con el lanzamiento 10,01 com‐
 +
      pilado con Visual C ++ 2010
 +
 
 +
      2012  -  MKD  12.03  está  adaptado a formato UTF-8 para traducciones y
 +
      internacionalización. En el mkdcppw estela se writen  para  decodificar
 +
      equipo C, C ++ y lenguajes PHP en modo gráfico con 'gcc' y 'gtkmm'.
 +
 
 +
DESCARGAS
 +
      http://edeulo.free.fr/wiki/index.php/Projet_mkd/Compilations_UNIX-LINUX
 +
 
 +
AUTORES
 +
      Manual actualizado por Clara Jimenez, Cardabela, y el JPL.
 +
 
 +
TRADUCTORES
 +
      Spanish : Alizée Louyot, Claudie Favier
 +
 
 +
      Email : http://edeulo.free.fr/contacts/formmail.php
 +
 
 +
NOTAS
 +
      Es  pertenecen  a  los programadores para cerrar comentarios, bloques y
 +
      líneas, por los códigos de cierre apropiados en los archivos de origen.
 +
 
 +
      Advertencia: El cierre de una línea de  comentario  es  un  retorno  de
 +
      carro (NL, LF, CR / LF) según sea el caso.
 +
 
 +
      Al final del archivo: esta nota implica un retorno de carro al final de
 +
      la línea de comentario. En este caso debe tener una línea en blanco  al
 +
      final del archivo de origen.
 +
 
 +
      No  es  que  no  permiten leer y decodificar los archivos incluidos por
 +
      #include en los archivos de fuentes.
 +
 
 +
FALLOS
 +
      Bugs Report: http://edeulo.free.fr/phpBB3/index.php
 +
 
 +
      Documentos extrator
 +
 
 +
 
 +
 
 +
                              6 de Abril, 2016                        MKD(1)
 +
</pre>
 +
{{Boîte déroulante/fin}}
 +
 
 +
=== Manuel mkd en français ===
 +
{{Boîte déroulante/début|titre=mkd Manuel fr (11 Mai 2013)}}
<pre style="color:white;background-color:black;">
<pre style="color:white;background-color:black;">
MKD(1)                                                                  MKD(1)
MKD(1)                                                                  MKD(1)
Ligne 448 : Ligne 695 :
{{Boîte déroulante/fin}}
{{Boîte déroulante/fin}}
-
=== Handbuch in German ===
+
=== mkd Handbuch in German ===
-
{{Boîte déroulante/début|titre=mkd-Handbuch de (6. April 2013)}}
+
{{Boîte déroulante/début|titre=mkd-Handbuch de (11. Mai 2013)}}
<pre style="color:white;background-color:black;">
<pre style="color:white;background-color:black;">
MKD(1)                                                                  MKD(1)
MKD(1)                                                                  MKD(1)
Ligne 649 : Ligne 896 :
{{Boîte déroulante/fin}}
{{Boîte déroulante/fin}}
-
== Sources ==
+
== Manuels / Manuals mkddocu ==
-
[http://edeulo.free.fr/pub/downloads/mkd-0~120508.tar.gz mkd-0~120508.tar.gz] (langs: en, fr) Available on DEBIAN, UBUNTU, FEDORA
+
-
== Mise à jour des traduction / Update translations ==
+
=== {{bleu|Manual mkddocu in english}} ===
-
'''''La mise à jour des traductions des messages est à distinguer de la mise à jour des manuels.
+
{{Boîte déroulante/début|titre=mkddocu Manual en (10 Mars 2014)}}
-
'''''
+
<pre style="color:white;background-color:black;">
-
*2012 :'''Les messages''' du code source '''étaient écrits en français ISO et ont été réécrit en anglais pour faciliter les traductions en UTF-8.'''
+
mkddocu(1)                            Linux User's Manual                          mkddocu(1)
-
*'''Depuis la version 12.03 les messages''' écrits en anglais '''font l'objet d'une traduction en français UTF-8'''
+
NAME
 +
      mkddocu  - This  shell  command generates the software documentations for all project
 +
      compatible with the software mkd.
-
*Décembre 2012 : les messages de la version 12.05 (120508)  sont traduits en allemand (de).
+
SYNOPSIS
 +
      mkddocu [project] [-s]
-
[http://edeulo.free.fr/telechargements/console-ubuntu/po/ '''Fichiers texte traduits, à traduire, ou à modifier''' (*.po)]
+
DESCRIPTION
 +
      The command mkd linked to mkddocu, extracts the special comments marked by a  benchmark
 +
      character.
 +
      Example : //D this is a php comment with a 'D' benchmark.
 +
      If  some  C files exist, then mkddocu will create a global header for the project, with
 +
      the benchmark character 'H'.
-
<big>[http://edeulo.free.fr/telechargements/console-ubuntu/mkd/Update_translations.tar.gz '''Mise à jour des traductions''' (Update translations) *.mo avec installeur : (de) (en) (fr)]</big>
+
      Benchmarks :
 +
      D - Extract the general documentation.
 +
      H - Extract comments from C files to create the global header file.
 +
      P - Creates the file useful for maintainers with General descriptions.
 +
      T - Creates the file useful for maintainers with the directives of tests.
 +
 
 +
OPTIONS
 +
      -project
 +
              This option allows to choose a project name which is different from the  default
 +
              name, else the project name is 'project'. If 'project' is the character '?'  the
 +
              command will show the syntax.
 +
 
 +
      -s    This option specifies that the command should create the strings file, and  also
 +
              the file of strings useful for translate with gettext and poedit.
 +
 
 +
RETURN VALUE
 +
      0  : End - when the command is complete or at the end of the help execution. (syntax)
 +
      -1 : mkd command is not found.
 +
      -2 : Command stopped. The backup is not performed.
 +
 
 +
EXAMPLES
 +
      The self-documentation of this command is created by the original file mkddocu.sh
 +
      Execute the command : 'mkddocu.sh mkddocu -s'
 +
      The directory maintenance/mkddocu contains the documents.
 +
      The  directories  of  projects  are generated by series and are stored in the directory
 +
      'Backups'  when the number of the series reaches the limit BACKUPSMAX
 +
      To test them, limit the value of BACKUPSMAX at 2. (3 backups by serie)
 +
 
 +
NOTES
 +
      BACKUPSMAX is normally fixed at 9 however you can modify this value by editing the file
 +
      /usr/bin/mkddocu.
 +
 
 +
SEE ALSO
 +
      mkd(1) xgettext(1) poedit(1)
 +
 
 +
DOWNLOADS
 +
      http://edeulo.free.fr
 +
 
 +
AUTHORS
 +
      Clara, JPL, Luca
 +
      Email : http://edeulo.free.fr/contacts/formmail.php
 +
 
 +
BUGS
 +
      Bug reports :  http://edeulo.free.fr/phpBB3/viewforum.php?f=14
 +
 
 +
                                          2014-02-24                                mkddocu(1)
 +
</pre>
 +
 
 +
{{Boîte déroulante/fin}}
 +
 
 +
=== {{bleu|Manuel mkddocu en français}} ===
 +
{{Boîte déroulante/début|titre=mkddocu Manuel fr (10 Mars 2014)}}
 +
<pre style="color:white;background-color:black;">
 +
mkddocu(1)                            Linux User's Manual                          mkddocu(1)
 +
 
 +
NOM
 +
      mkddocu  - Cette commande shell génère la documentation informatique de tout fichier de
 +
      projet reconnu par le logiciel mkd.
 +
 
 +
SYNOPSIS
 +
      mkddocu [projet] [-s]
 +
 
 +
DESCRIPTION
 +
      La commande mkd associée à mkddocu,  extrait  les  commentaires  dotés  d'un  caractère
 +
      repère.
 +
      Exemple : //D ceci est un commentaire php répéré par le caractère 'D'
 +
      Si  des  fichiers de langage C sont présents, mkddocu génère un fichier d'entête global
 +
      (header) du projet informatique.
 +
 
 +
      Repère :
 +
      D - Extrait la documentation générale.
 +
      H - Crée le fichier d'entête global (header) si un fichier C est présent.
 +
      P - Extrait un document utile aux mainteneurs, noms, dates, versions, etc.
 +
      T - Extrait le document des directives de tests. (Unitaires, d'intégration, etc.)
 +
 
 +
OPTIONS
 +
      projet Cette option permet de choisir un nom de projet différent de project par défaut.
 +
              Si 'projet' est le caractère '?' la commande affiche la syntaxe.
 +
 
 +
      -s    Cette option précise qu'il faut générer le fichier des chaînes de caractères  et
 +
              le fichier des chaînes utiles aux traductions avec gettext et poedit.
 +
 
 +
VALEURS RETOURNÉES
 +
      0 : Fin normale à la fin de l'exécution de la commande ou de l'aide (syntaxe).
 +
      -1 : La commande mkd n'est pas installée.
 +
      -2 : Arrêt de la commande.  La sauvegarde de la série de documents dans Backups n'a pas
 +
      été effectuée.
 +
 
 +
EXEMPLES
 +
      L'auto-documentation de cette commande se crée avec le fichier d'origne mkddocu.sh
 +
      Lancer la commande 'mkddocu.sh mkddocu -s'
 +
      Le répertoire maintenance/mkddocu contiendra les documents.
 +
      Les répertoires de projet sont générés par séries et peuvent avoir été sauvegardés dans
 +
      un  répertoire Backups si le nombre de fichiers de projet de la série a atteind la lim‐
 +
      ite BACKUPSMAX
 +
      Pour les essais on peut se limiter à BACKUPSMAX=2 (3 'backups' par série.)
 +
 
 +
REMARQUES
 +
      BACKUPSMAX est normalement fixé à 9 mais peut être modifié par  édition  du  fichier  :
 +
      /usr/bin/mkddocu.
 +
 
 +
VOIR AUSSI
 +
      mkd(1) xgettext(1) poedit(1)
 +
 
 +
TÉLÉCHARGEMENTS
 +
      http://edeulo.free.fr
 +
 
 +
AUTEURS
 +
      Clara, JPL, Luca
 +
      Email : http://edeulo.free.fr/contacts/formmail.php
 +
 
 +
BUGS
 +
      Rapports de bugs :  http://edeulo.free.fr/phpBB3/viewforum.php?f=14
 +
 
 +
                                          2014-02-24                                mkddocu(1)
 +
</pre>
 +
 
 +
{{Boîte déroulante/fin}}
 +
 
 +
[http://edeulo.free.fr/phpBB3/viewtopic.php?f=16&t=323 Discussion / Forum : Bug on mkddocu 140515]
 +
 
 +
== Mise à jour des traductions / Update translations ==
 +
; Votre aide à la traduction serait bienvenue.
 +
<!--: [http://edeulo.free.fr/telechargements/console-ubuntu/po/po.tar.gz Fichiers texte traduits, à traduire, ou à modifier (*.po)]-->
 +
: [https://fr.wikibooks.org/wiki/Mkd_%28Extracteur_de_documents%29/Internationalisation_des_messages internationalisation des messages sur wikibook]
== Aide / Help ==
== Aide / Help ==
-
[[Projet mkd/mkd/Aide]]
 
-
[[Projet mkd/mkd/Help]]
+
[[:wikibooks:fr:Mkd_(Extracteur_de_documents)|'''Wikibooks: Aide et exercices pour utiliser mkd''']]
 +
 
 +
[[Projet mkd/mkd/Aide|Aide simple]]
 +
 
 +
[[Projet mkd/mkd/Help|Simple help]]
== Bugs ==
== Bugs ==

Version actuelle en date du 19 septembre 2018 à 19:52

Ubuntu
Debian
Fedora

Retour au portail mkd

See also Projet_mkd/téléchargements/UNIX_LINUX Beta and unstable versions.


Sommaire

Distributions Ubuntu / Update packages on launchpad.net

Dernières versions à jour mkd - 140315 Saucy, 140515 Trusty et 140515 Utopic.

mkd 140515 is updated for Trusty (Ubuntu 14.04) and Utopic (Ubuntu 14.10) and is available for Ubuntu Vivid (15.04)
Télécharger le fichier .deb correspondant à votre processeur puis cliquez deux fois sur le fichier téléchargé pour l'installer.

Adding this PPA to your system
Téléchargements (sources et binaires) de la dernière version

Mettre votre liste des paquets à jour

deb http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu <version ubuntu> main
deb-src http://ppa.launchpad.net/jean-paul-louyot/mkd/ubuntu <version ubuntu> main
En cas d'échec avec deb 
Pour les mises à jour automatiques : sudo add-apt-repository ppa:jean-paul-louyot/mkd
Pour récupérer les fichiers source : apt-get source mkd après installation des mises à jour automatiques.

Convertir les paquets Debian

Alien convertit les paquets deb dans les formats rpm, dpkg, stampede slp, et slackware tgz
Site officiel Alien ; Télécharger le logiciel Alien

Convertir un paquet .deb en .rpm

Commande suggérée :

sudo alien -r mkd-doc_140515_all.deb
Installation des paquets rpm convertis avec Alien 

Il peut y avoir un conflit entre les systèmes de fichiers avec la commande yum. Utiliser la commande rpm :

Exemple :

sudo rpm -ivh mkd-doc-140515-2.noarch.rpm --force

Distributions de mkd en paquets Debian, RPM, Windows

Certains paquets sont convertis avec Alien d'autres sont mis en paquets avec Fedora 23

2018-09-19 Téléchargements sur la Disk station EELL

Manuels / Manuals mkd

(man1) (man3)
- Téléchargez a mise à jour des manuels incluse dans les fichiers de translations

Manual mkd in english

Manual mkd en español

Manuel mkd en français

mkd Handbuch in German

Manuels / Manuals mkddocu

Manual mkddocu in english

Manuel mkddocu en français

Discussion / Forum : Bug on mkddocu 140515

Mise à jour des traductions / Update translations

Votre aide à la traduction serait bienvenue.
internationalisation des messages sur wikibook

Aide / Help

Wikibooks: Aide et exercices pour utiliser mkd

Aide simple

Simple help

Bugs

Forum Rapports de bugs / Bugs report
Outils personnels