Skip to content

Commit

Permalink
reestructuracion del makefile para docs
Browse files Browse the repository at this point in the history
  • Loading branch information
poligarcia committed Dec 4, 2018
1 parent f71b080 commit cf74f58
Show file tree
Hide file tree
Showing 4 changed files with 45 additions and 2 deletions.
15 changes: 15 additions & 0 deletions Makefile
@@ -1,4 +1,19 @@
SHELL = bash

.PHONY: docs servedocs doctoc

servedocs:
mkdocs serve

mkdocsdocs:
mkdocs build
rsync -vau --remove-source-files site/ docs/
rm -rf site

docs: doctoc mkdocsdocs

doctoc: ## generate table of contents, doctoc command line tool required
## https://github.com/thlorenz/doctoc
doctoc --maxlevel 4 --github --title "## Indice" docs/
find docs/ -name "*.md" -exec bash fix_github_links.sh {} \;

12 changes: 12 additions & 0 deletions docs/css/extra_rtd.css
@@ -0,0 +1,12 @@
table {
text-align: center;
margin: 0 auto;
}

tbody {
display: inline;
}

.wy-nav-top {
background: rgb(0, 0, 185);
}
18 changes: 16 additions & 2 deletions mkdocs.yml
@@ -1,8 +1,12 @@
site_name: Portal Andino
pages:
site_author: Datos Argentina
site_description: Documentación de Portal Andino, la distribución de CKAN desarrollada por la República Argentina dockerizada, fácil de instalar y compatible con el Perfil Nacional de Metadatos de la Política de Apertura de Datos.
repo_url: https://github.com/datosgobar/portal-andino/

nav:
- Inicio: 'index.md'
- Comienzo rápido: 'quickstart.md'
# - Manual de uso: 'usage.md'
- Manual de uso: 'usage.md'
- Desarrollo:
- Instalación: 'developers/install.md'
- Actualización: 'developers/update.md'
Expand All @@ -12,5 +16,15 @@ pages:
- Configuración HTTPS: 'developers/https.md'
- Configuración de DNS: 'developers/dns.md'
- Generación de imágenes Docker: 'developers/docker.md'
- Desarrollo: 'developers/development.md'
- Tests: 'developers/tests.md'

theme: datosgobar_docs

markdown_extensions: [fenced_code, codehilite, admonition]

extra_css:
- css/extra_rtd.css

google_analytics: ['UA-91435482-1', "https://portal-andino.readthedocs.io/"]

2 changes: 2 additions & 0 deletions requirements-docs.txt
@@ -0,0 +1,2 @@
mkdocs<1.1
mkdocs-datosgobar

0 comments on commit cf74f58

Please sign in to comment.