Notas sobre programación en C creadas con mkdocs.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
docs
.gitignore
README.md
mkdocs.yml

README.md

Curso de C

Tutorial para iniciarse en la programación con lenguaje C elaborado con mkdocs.

El resultado de este proyecto está publicado en esta página.

Acerca de mkdocs

mkdocs es una herramienta para crear documentación.
Entre sus ventajas destacan las siguientes:

  • Permite escribir en lenguaje markdown.
  • Es posible utilizar extensiones, por ejemplo, para resaltar en colores código.
  • Incluye un servidor web que permite visualizar los cambios según vamos escribiendo.
  • Permite crear facilmente un sitio web estático con la documentación generada.

Instalación

Comprobaremos si tenemos instalado Python y PIP con los siguientes comandos:

python --version
pip --version

En caso de no tenerlos instalados, podemos hacerlo instalando Anaconda. En caso de tenerlos instalados, actualizaremos pip a la última versión con el siguiente comando:

pip install --upgrade pip

A continuación ya podemos instalar mkdocs con el siguiente comando:

pip install mkdocs

Tras la instalación podemos comprobar la versión instalada con:

mkdocs --version 

En caso de utilizar el tema material para mkdocs lo instalaremos de la siguiente forma:

pip install mkdocs-material

Para utilizar la extensión CodeHilite es necesario instalar pygments:

pip install pygments

Para utilizar la extensión PyMdown que entre otros paquetes incluye arithmatex (MathJax) es necesario instalarla:

pip install pymdown-extensions

Comandos

  • mkdocs new [dir-name] - Create a new project.
  • mkdocs serve - Start the live-reloading docs server.
  • mkdocs build - Build the documentation site.
  • mkdocs help - Print this help message.

Pasos para comenzar la edición

  1. Abrir una consola DOS.

  2. Teclear (incluyendo la ruta a la carpeta de trabajo):

    cd Documents/mkdocs/curso-c
    mkdocs serve
    
  3. Abrir el navegador en http://127.0.0.1:8000/

  4. Comenzar la edición de los documentos.