Merge remote-tracking branch 'ecoreng/master': Spanish translation

es/Makefile

@@ -0,0 +1,132 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = ../build
+PYTHON        = python
+LANG          = en
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees/$(LANG) $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+
+clean:
+	-rm -rf $(BUILDDIR)/*
+
+html:
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html/$(LANG)
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html/$(LANG)."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp/$(LANG)
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp/$(LANG)."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/CakePHPCookbook.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/CakePHPCookbook.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/CakePHPCookbook"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/CakePHPCookbook"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub/$(LANG)
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub/$(LANG)."
+
+latex:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex/$(LANG)
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex/$(LANG)."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf:
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex/$(LANG)
+	@echo "Running LaTeX files through pdflatex..."
+	make -C $(BUILDDIR)/latex/$(LANG) all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex/$(LANG)."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."

es/about.rst

@@ -0,0 +1,12 @@
+Acerca de Croogo
+################
+
+Croogo es un sistema de gesion de contenidos gratuito y de codigo abierto para PHP, liberado con la licencia MIT. Es construido sobre el frameworks de CakePHP.
+
+Fue presentado por primera vez el 7 de Octubre del 2009 por `Fahad Ibnay Heylaal <http://fahad19.com>`_.
+
+.. toctree::
+
+    about/license
+    about/roadmap
+    about/contributors

es/about/contributors.rst

@@ -0,0 +1,4 @@
+Contribuyentes
+############
+
+Para ver una lista completa de contribuyendes al nucleo, visita `GitHub <http://github.com/croogo/croogo/contributors>`_.

es/about/license.rst

@@ -0,0 +1,12 @@
+Licencia
+#######
+
+Licencia MIT
+
+Croogo : Un sistema de gestion de contenidos desarrollado con CakePHP (http://www.croogo.org)
+Derechos reservados 2012, Fahad Ibnay Heylaal <[email protected]>
+
+Se le autoriza el permiso, sin cargo alguno, a cualquier persona que obtenga una copia de este software y la documentacion asociada (el "Software"), para distribuir sin restriccion, incluyendo y sin limitantes los derechos de uso, copia, modificacion, union, publicacion, distribucion, sublicencia y/o vender copias del Software, y de permitir a las personas a las que se les distribuye el software de hacer lo mismo sujeto a las siguientes condiciones:
+La notificacion de derechos de copia debe ser incluido en todas las copias o porciones sustanciales del Software.
+
+EL SOFTWARE ES PROVISTO "COMO ESTA", SIN GARANTIA DE NINGUN TIPO, EXPRESA O IMPLICITA, INCLUYENDO PERO NO LIMITADO A GARANTIAS DE COMERCIALIZACION, APTITUD PARA UN PROPOSITO EN PARTICULAR Y SIN INFRACCION. EN NINGUN CASO LOS AUTORES O PROPIETARIOS DE LOS DERECHOS SERAN RESPONSABLES POR NINGUN RECLAMO, DAÑOS U OTRA RESPONSABILIDAD, YA SEA EN ACCION DEL CONTRATO, AGRAVIO DE CUALQUIER TIPO QUE SURJA DE EL USO O EN CONEXION CON EL SOFTWARE O DEL USO U OTROS TRATOS DEL SOFTWARE.

es/about/roadmap.rst

@@ -0,0 +1,47 @@
+.. role:: strike
+   :class: strike
+
+Camino seguido
+
+2.0.x
+-----
+
+- :strike:`Fully Pluginize: Croogo can become a set of plugins and a minimalist app that simply installs the default plugin set for easy installation.` **(shama, real34, rchavik)**
+- Add namespaces
+- PSR-0 and PSR-1 Compat
+- Use composer.json instead of Config/plugin.json for extensions
+- Offer RESTful API by core, to allow easy integration with third-party apps (could be an iPhone app too)
+- Allow admins to update Croogo from admin panel (HTTP download, or backed by Git?)
+- :strike:`Granular ACL` **(rchavik)**
+- [Plugin] Contents: Nodes going out, forming a Contents plugin.
+
+1.5.2
+-----
+- Going stable
+- Doc updates
+
+1.5.1
+-----
+- :strike:`Plugin Activation ordering and presentation in plugin list`
+- :strike:`Helpers to create UI components markups, eg: tabs, accordion, panels.  Mostly for /admin` **(aymeric and real34 - occitech)**
+- :strike:`Replace Email Component with CakeEmail and move to models`
+- :strike:`Move functionality in NodesController to the model`
+
+1.5.0
+-----
+
+- Plugin download/finder via shell (the CPM - package management idea)
+- :strike:`Default theme: use Twitter Bootstrap` (default theme will not be changed)
+- :strike:`Admin theme: use Twitter Bootstrap here too?` **(aymeric and real34 - occitech)**
+- Node Preview indicator, display published nodes that has preview flag set for admins.
+- :strike:`Defaults to InnoDb storage engine for mysql`
+- :strike:`Migration plugin (cakedc) can be use for installation, and plugins. create and update tables between versions, setup default/baseline data [http://croogo.lighthouseapp.com/projects/32818/tickets/258]` **(aymeric and real34 - occitech)**
+- :strike:`Pluginify the File Manager, add better folder security` **(shama)**
+- :strike:`Pluginify Blocks` **(shama)**
+- :strike:`Pluginify Taxonomy` **(shama)**
+- :strike:`Move CommentsController::add() functionality to model`
+- :strike:`Move AttachmentsController::admin_add functionality to model`
+- :strike:`Move non-controller CroogoComponent functionality to a Lib`
+- :strike:`Pluginify User management (extract as plugin)` **(rchavik)**
+- Allow integration of third party auth, eg: twitter oauth, facebook, ldap,
+- :strike:`Replace Config/settings.yml to Config/settings.json, remove spyc from Vendor` **(rchavik)**

es/administrators.rst

@@ -0,0 +1,13 @@
+Administradores
+===============
+
+.. toctree::
+
+  administrators/content
+  administrators/menus
+  administrators/blocks
+  administrators/extensions
+  administrators/media
+  administrators/contacts
+  administrators/users
+  administrators/settings

es/administrators/blocks.rst

@@ -0,0 +1,51 @@
+Bloques
+#######
+
+Bloques son lo que ves en la barra lateral (region 'Derecha' en la plantilla por defecto) como cajas. Pertenecen a una region en particular.
+
+Elementos
+=========
+
+Todos los bloques son mostrados a traves del elemento block.ctp (que se encuentra en app/Plugin/Blocks/View/Elements/block.ctp). Puedes hacer uso de tu propio elemento tambien para tus bloques al editar el campo de 'elemento' cuando agregas un bloque.
+
+Tip: Si es un elemento de un plugin, ingresa 'NombrePlugin.nombre_elemento'.
+
+Como mostrar "Esto" y "Aquello" en un bloque?
+=============================================
+
+Puedes mostrar un elemento, menu, vocabulario (lista anidada de terminos), o una lista de nodos al ingresarla con un formato especial en el cuerpo de tu bloque.
+
+Elemento
+--------
+
+Para un elemento con un nombre de archivo mi_elemento.ctp
+    [element:mi_elemento] O [e:mi_elemento]
+
+Pasando una variable a tu elemento:
+
+    [element:mi_elemento miVar="valor aqui" otraVar="valor aqui"]
+
+Para elemento de plugins:
+
+    [element:mi_elemento plugin="mi_plugin"]
+
+
+Menu
+----
+
+Para un menu con alias de 'principal'
+    [menu:principal] o [m:principal]
+
+
+Vocabulario
+-----------
+
+Para un vocabulario con alias de 'categorias':
+
+    [vocabulary:categorias] OR [v:categorias]
+
+Nodos
+-----
+
+Por ejemplo, si quieres mostrar una lista de los 5 nodos mas recientes como un bloque:
+    [node:recent_posts conditions="Node.type:blog;Node.status:1" order="Node.id DESC" limit="5"]

es/administrators/contacts.rst

@@ -0,0 +1,4 @@
+Contactos
+#########
+
+Casi toda pagina web necesita algun tipo de formulario de contacto donde los visitantes pueden enviar un mensaje. Croogo tiene esta caracteristica ya incluida

es/administrators/content.rst

@@ -0,0 +1,12 @@
+Contenido
+#########
+
+En Croogo, cada pieza de contenido es llamada Nodo. Por ejemplo, si tienes una publicacion de blog titulada "Hola Mundo", eso es un nodo. Pero es importante entender que los comentarios asociados con esa publicacion NO son nodos.
+
+.. toctree::
+
+  content/content-types
+  content/taxonomy
+  content/custom-fields
+  content/meta-tags
+  content/multilingual

es/administrators/content/content-types.rst

@@ -0,0 +1,23 @@
+Tipos de contenido
+=============
+
+Por defecto, hay 3 tipos de contenido
+- Paginas: para paginas
+- Blog: para publicaciones
+- Nodo: si no estas seguro de que tipo de contenido usar
+
+Si crees que requieres un tipo de contenido nuevo, puedes crearlo desde el panel de control
+
+Parametros
+==========
+
+Cuando agrega o edita tipos de contenido, encontraras un campo de 'Params' (parametros), donde podras ingresar parametros. Se espera que ingrese un parametro por linea con los segmentos de indice, valor utilizando el signo de "igual". Ejemplo:
+
+    my_indice_parametro=valor_aqui
+    otro_indice=otro_valor
+
+Los valores validos para indices en los tipos de contenido son:
+- nodes_per_page: Espera un valor unitario mayor a 0 para los limites de paginacion de los nodos
+- routes: Espera 0 o 1 para urls limpias como `/type-alias/node-slug`
+
+Eres libre de ingresar mas parametros conforme sean disponibles en un formato correcto desde `ParamsBehavior <http://github.com/croogo/croogo/blob/master/models/behaviors/params.php>`_.

es/administrators/content/custom-fields.rst

@@ -0,0 +1,4 @@
+Campos personalizados
+#############
+
+Cuando creas un nodo nuevo, te daras cuenta que existe una pestaña de 'Custom fields' (campos personalizados). Esta te permitira ingresar informacion extra que sera util para las plantillas.

es/administrators/content/meta-tags.rst

@@ -0,0 +1,9 @@
+Etiquetas Meta
+#########
+
+Puedes controlar las etiquetas meta de tus nodos utilizando campos personalizados. Utiliza los siguientes indices:
+
+- meta_keywords: para palabras clave
+- meta_description: para la descripcion
+
+Cualquier indice de campo personalizado que inicie con `meta_` sera tratado como una etiqueta meta dentro de `<head>`.

es/administrators/content/multilingual.rst

@@ -0,0 +1,17 @@
+Multilenguaje
+############
+
+Croogo viene con un plugin de Traduccion. Al activarlo desde la pagina de Extensiones > Plugins te permitira que traduzcas tu contenido en otros lenguajes.
+
+Por defecto, este soporta traducciones de Nodos, Bloques, y Vinculos. Puedes agregar mas al editar el archivo /app/plugins/translate/config/translate_bootstrap.php .
+
+Cuando vas al indice de pagias como por ejemplo: Nodos (Contenido > Listar), te daras cuenta un boton con la etiqueta de `Traducir` para cada elemento.
+
+Lenguajes
+=========
+
+Antes de iniciar las traducciones de tu contenido, necesitaras declarar en Croogo en cual otro lenguaje deseas que tu contenido sea traducido. Puedes administrar esto desde la pagina de Settings > Languages (preferencias > lenguajes).
+
+Ver contenido desde la parte publica de tu sitio
+================================================
+Visita http://your-site.com/spa desde tu navegador donde spa es el Locale del lenguaje Español

es/administrators/content/taxonomy.rst

@@ -0,0 +1,16 @@
+Taxonomias
+########
+
+Eres libre de organizar tu contenido de tantas maneras como quieras.
+
+Vocabulario
+===========
+
+Los vocabularios son colecciones de terminos. Por ejemplo, si tienes una lista de categorias (incluyendo Personal, Viajes, Noticias, etc) podemos llamar a esta lista un Vocabulario. Y puedes nombrar a ese vocabulario 'Categorias'. Lo mismo puede hacerse con las etiqueta - un vocabulario llamado 'etiquetas'.
+
+Por defecto, Croogo tiene 2 vocabularios: Categorias y Etiquetas.
+
+Termino
+=======
+
+Del ejemplo anterior: Personal, Viaje, y Noticias son Terminos, y pueden ser asociados con Nodos.

es/administrators/extensions.rst

@@ -0,0 +1,10 @@
+Extensiones
+###########
+
+Las extensiones en Croogo pueden ser de 3 tipos. Temas, Plugins o Configuraciones regionales. Todas ellas ayudan a extender las caracteristicas de Croogo.
+
+.. toctree::
+
+  extensions/locales
+  extensions/plugins
+  extensions/themes