PHPackages nepenteh/docma - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Parsing & Serialization](/categories/parsing) 4. / 5. nepenteh/docma ActiveProject[Parsing & Serialization](/categories/parsing) nepenteh/docma ============== Visor de Documentación Markdown v1.0.2(3y ago)08MITPHP Since Apr 17Pushed 3y ago1 watchersCompare [ Source](https://github.com/nepenteh/docma)[ Packagist](https://packagist.org/packages/nepenteh/docma)[ RSS](/packages/nepenteh-docma/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (2)Versions (4)Used By (0) DOCMA (Documentación MarkDown) ============================== [](#docma-documentación-markdown) José Manuel Rosado Hurtado 2023 - [ejerciciosmesa.com](http://ejerciciosmesa.com) Descripción ----------- [](#descripción) **DOCMA** es un visor de documentación creada con texto en formato MarkDown. Permite crear una documentación interactiva rápida usando este tipo de documentos. La navegación en la documentación creada es fácil gracias a la creación automática de un índice, y el acceso a los temas resulta rápido e intuitivo. Por otro lado la documentación creada con DOCMA puede ser publicada en un servidor para el acceso de todo aquél que necesite consultarla. Creación de un proyecto de documentación ---------------------------------------- [](#creación-de-un-proyecto-de-documentación) Para crear un proyecto de documentación ejecute el siguiente comando en la consola: ``` composer create-project nepenteh/docma ``` Esto creará una carpeta *docma* y dentro de ella debe prestar especial atención a los siguientes elementos: **Carpeta: /public/Contents** Esta carpeta contendrá los distintos archivos markdown que formarán la documentación que quiere mostrar. Como ejemplo se incluye en el proyecto instalado una documentación sobre el Sistema Solar. Estos archivos deben ser eliminados y sustituidos por los suyos propios. **Archivo .env** Este archivo tiene tres datos configurables: el título de su documentación, el nombre de la carpeta con los contenidos y el archivo CSS de estilos propios de su documentación. - **Título de su documentación.** Escriba el título general que quiere asignarle a su documentación. Este título aparecerá en la parte superior de la pantalla. - **Nombre de la carpeta de contenidos.** Escriba el nombre que quiera darle a la carpeta que contiene los contenidos de su documentación. Por defecto es *Contents*. Debe tener en cuenta que si cambia este nombre debe cambiar el nombre de la carpeta *Contents* que se encuentra en la carpeta */public*. - **Nombre del archivo CSS de estilos propios de la documentación.** Este archivo CSS se encuentra dentro de la carpeta */public/css* y puede ser personalizado para cambiar los estilos de su documentación. Indique aquí el nombre que quiere asignarle a ese archivo y asegúrese de que existe dentro de la carpeta */public/css*. Proceso de creación de documentación con Docma ---------------------------------------------- [](#proceso-de-creación-de-documentación-con-docma) ### Creación de archivos con los contenidos. [](#creación-de-archivos-con-los-contenidos) Escriba cada tema en un archivo markdown siguiendo las reglas de este lenguaje de marcado. Estos archivos deben tener un nombre que empiece por el número de tema y el número de apartado separado por un guión. A continuación indique un nombre para el archivo separándolo con un guión bajo. Aquí tiene un ejemplo de archivos nombrados con la especificación para Docma: - 01-00\_Europa.md - 01-01\_España.md - 01-02\_Italia.md - 01-03\_Francia.md - 01-04\_Alemania.md - 02-00\_Africa.md - 02-01\_Nigeria.md - 02-02\_Camerún.md - 02-03\_Marruecos.md - 03\_00\_Asia.md - 03\_01\_China.md - 03\_02\_India.md Estos archivos definen tres temas principales: Europa, África y Asia, y dentro de cada estos temas hay distintos apartados correspondientes a varios países de cada continente. Si los nombres están creados de forma correcta, el visor Docma será capaz de crear automáticamente un índice en la parte izquierda de la pantalla con los temas y apartados, así como unos botones de navegación al final de cada tema que permiten pasar al tema siguiente o anterior. Todos los archivos markdown creados de esta forma deben estar dentro de una carpeta que puede llamarse de la forma que quiera, y que debe estar dentro de la carpeta */public*. Por defecto esta carpeta es la carpeta */public/Contents* #### Imágenes y otros elementos de la documentación [](#imágenes-y-otros-elementos-de-la-documentación) La carpeta *Contents* puede además contener una subcarpeta *imagenes* donde se almacenen imágenes que se usarán en la documentación (u otras carpetas con otros contenidos que desee). Si quiere especificar una ruta a una de las imágenes de la subcarpeta *imagenes* de su documentación, use 'Contents/imagenes/fichero\_de\_imagen.extension' para que el acceso sea el correcto. (Puede consultar los archivos markdown de ejemplo incluidos en el proyecto) #### Enlaces a otros temas de la documentación [](#enlaces-a-otros-temas-de-la-documentación) El acceso a un tema concreto se hace usando el index.php con el parámetro de URL *cnt* asignado a la numeración del tema. Así por ejemplo, si quiere crear un enlace en un archivo markdown de su documentación que apunte al tema "Alemania" cuya numeración es 01\_04, debe indicar lo siguiente: ``` [Alemania](index.php?cnt=01_04) ``` ### Estilos CSS [](#estilos-css) La carpeta del proyecto Docma contiene un arhivo CSS llamado **visordoc.css** dentro de una carpeta */public/css*. Este archivo define los estilos básicos para el funcionamiento del visor y no debería tocarse. Sin embargo, es posible añadir otro archivo CSS en la carpeta que defina estilos personalizados para la documentación. Añada este nuevo archivo css y no olvide indicar el nombre de este archivo en la configuración del archivo de variables de entorno .env Documentación de Ejemplo Sistema Solar -------------------------------------- [](#documentación-de-ejemplo-sistema-solar) Este proyecto incluye como ejemplo una documentación con información sobre el Sistema Solar. (La información de ejemplo incluida en esta demo ha sido extraída de Wikipedia) También incluye un archivo *planetas.css* que define estilos propios para esta documentación. [![Ejemplo DOCMA](https://camo.githubusercontent.com/94684fedadb8ff34f652756812bcee341f21da8bf584dd1edf6600ec335fa027/68747470733a2f2f656a6572636963696f736d6573612e636f6d2f696d616765732f646f636d612f646f636d615f656a656d706c6f2e706e67)](https://camo.githubusercontent.com/94684fedadb8ff34f652756812bcee341f21da8bf584dd1edf6600ec335fa027/68747470733a2f2f656a6572636963696f736d6573612e636f6d2f696d616765732f646f636d612f646f636d615f656a656d706c6f2e706e67) Tanto los archivos markdown de ejemplo como el archivo css deberían ser sustituidos por la documentación propia que creará el usuario. Puede acceder a un ejemplo de documentación publicada con Docma en el siguiente enlace: [Documentación Generador de Código DUENDE](https://ejerciciosmesa.com/duende) ### Health Score 21 — LowBetter than 19% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 1126d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7f4bd01c5cc2a0b3c697b4c85742d83c0d5a71004688ca9adc0208c47d4e85da?d=identicon)[nepenteh](/maintainers/nepenteh) --- Top Contributors [![nepenteh](https://avatars.githubusercontent.com/u/109131721?v=4)](https://github.com/nepenteh "nepenteh (20 commits)") --- Tags ayudacontentsdocdocumentaciondocumentationdocumentation-generatordocumentation-toolhelpmarkdowntabletable-contentsvisor ### Embed Badge ![Health badge](/badges/nepenteh-docma/health.svg) ``` [![Health](https://phpackages.com/badges/nepenteh-docma/health.svg)](https://phpackages.com/packages/nepenteh-docma) ``` ### Alternatives [tightenco/jigsaw Simple static sites with Laravel's Blade. 2.2k438.5k29](/packages/tightenco-jigsaw)[kartik-v/yii2-markdown Advanced Markdown editing and conversion utilities for Yii Framework 2.0 88265.8k6](/packages/kartik-v-yii2-markdown)[maglnet/magl-markdown Provides a ZF2 View Helper to render markdown syntax. It uses third-party libraries for the rendering and you can switch between different renderers. 22178.2k4](/packages/maglnet-magl-markdown)[joomlatools/pages Joomlatools Pages is a very fast just-in-time page generator and flexible framework that makes building websites with any CMS, API, or database fun again. It can be installed in Joomla as a component, or be used standalone 473.7k](/packages/joomlatools-pages)[cartalyst/interpret A driver-based content rendering package, with support for HTML, Markdown & plain text. You can register custom drivers for custom content types. 1914.7k](/packages/cartalyst-interpret)[undefinedoffset/silverstripe-markdown Adds a field and a data type that allows for Markdown editing, uses the github api to render the html 126.5k1](/packages/undefinedoffset-silverstripe-markdown) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)