Hi Ihor, Thanks for the follow-up. Attached is an updated patch:
- Dropped es/.gitignore. You are right that the rest of the repo does not use per-directory ignore files, so the generated .html pages are now simply left untracked, as for the other languages. - Reworded the commit message so it describes the overall change (adding the Spanish translation) instead of the last review iteration. - Added the "es" entry to org-html-postamble-format in publish.sh, and turned es/resources/postamble.html into a real, translated footer (it was previously a symlink to the English one), mirroring zh-CN. About the FSF copyright assignment: I am checking with Laura whether she has already completed it and will get back to you. Best regards, Andros
>From e14d8d10e2ac326cd67478416d9e67d25249cc45 Mon Sep 17 00:00:00 2001 From: Andros Fenollosa <[email protected]> Date: Wed, 29 Jul 2026 21:42:43 +0200 Subject: [PATCH] Add Spanish (es) translation of the website Add a complete Spanish translation of orgmode.org under es/, following the layout of the existing zh-CN translation: only the .org sources, the hand-written org-demo.html and the shared resources/ are tracked, while the generated .html pages are left untracked (as for the other languages). * es/index.org, es/features.org, es/quickstart.org, es/manuals.org, es/tools.org, es/Changes.org, es/LICENSE.org, es/setup.org: New files, Spanish translation of the corresponding English pages. * es/org-demo.html: New file, translated interactive demo. * es/resources/preamble.html, es/resources/postamble.html: New files, translated navigation menu and footer. * es/resources/fonts, es/resources/img, es/resources/js, es/resources/style, es/resources/normal-outline-3.html, es/resources/oembed-info.json: New symlinks to the shared resources. * resources/preamble.html, zh-CN/resources/preamble.html: Add the es entry to the language switcher. * publish.sh (org-html-postamble-format): Register the es postamble. Spanish translation by Laura Herrero <[email protected]>. --- es/Changes.org | 23 ++ es/LICENSE.org | 7 + es/features.org | 284 ++++++++++++++++++++ es/index.org | 301 +++++++++++++++++++++ es/manuals.org | 32 +++ es/org-demo.html | 132 +++++++++ es/quickstart.org | 261 ++++++++++++++++++ es/resources/fonts | 1 + es/resources/img | 1 + es/resources/js | 1 + es/resources/normal-outline-3.html | 1 + es/resources/oembed-info.json | 1 + es/resources/postamble.html | 17 ++ es/resources/preamble.html | 25 ++ es/resources/style | 1 + es/setup.org | 32 +++ es/tools.org | 411 +++++++++++++++++++++++++++++ publish.sh | 1 + resources/preamble.html | 1 + zh-CN/resources/preamble.html | 1 + 20 files changed, 1534 insertions(+) create mode 100644 es/Changes.org create mode 100644 es/LICENSE.org create mode 100644 es/features.org create mode 100644 es/index.org create mode 100644 es/manuals.org create mode 100644 es/org-demo.html create mode 100644 es/quickstart.org create mode 120000 es/resources/fonts create mode 120000 es/resources/img create mode 120000 es/resources/js create mode 120000 es/resources/normal-outline-3.html create mode 120000 es/resources/oembed-info.json create mode 100644 es/resources/postamble.html create mode 100644 es/resources/preamble.html create mode 120000 es/resources/style create mode 100644 es/setup.org create mode 100644 es/tools.org diff --git a/es/Changes.org b/es/Changes.org new file mode 100644 index 0000000..a690461 --- /dev/null +++ b/es/Changes.org @@ -0,0 +1,23 @@ +#+title: Notas de la versión | Org mode +#+setupfile: setup.org +#+link: git https://git.savannah.nongnu.org/cgit/org-mode.git/commit/?id=%s +#+link: doc https://orgmode.org/worg/doc.html#%s +#+link: msg https://list.orgmode.org/%s +#+description: Org Org-mode Emacs cambios ChangeLog notas de la versión +#+macro: kbd (eval (org-texinfo-kbd-macro $1)) +#+include: "./resources/preamble.html" export html + +#+include: "./resources/normal-outline-3.html" export html + +@@html:<br/>@@ + +Puedes mantenerte al tanto de los próximos cambios, solicitudes de ayuda (requests), reportes de errores y parches enviados consultando la página web [[https://tracker.orgmode.org][tracker.orgmode.org]] y suscribiéndote a los canales de RSS disponibles. + +# Pull the latest Changelog from bugfix. +# This relies upon .build.yml pulling Org mode git repo to ~/org-mode +# and checking out bugfix. +#+INCLUDE: "~/org-mode/etc/ORG-NEWS::Version" + +* Cambios previos + +Para cambios previos, consulta [[https://orgmode.org/worg/org-release-notes.html][las notas completas de la versión]]. diff --git a/es/LICENSE.org b/es/LICENSE.org new file mode 100644 index 0000000..bc1afdc --- /dev/null +++ b/es/LICENSE.org @@ -0,0 +1,7 @@ +# This file is released by its authors and contributors under the GNU +# Free Documentation license v1.3 or later, code examples are released +# under the GNU General Public License v3 or later. + +El contenido de este repositorio está licenciado bajo la [[https://www.gnu.org/licenses/fdl-1.3.html][Licencia de Documentación Libre de GNU version 1.3 o posterior]]. + +Los ejemplos de código y hojas de estilo CSS están licenciadas bajo la [[https://www.gnu.org/licenses/gpl-3.0.html][Licencia Pública General de GNU v3 o posterior]]. diff --git a/es/features.org b/es/features.org new file mode 100644 index 0000000..0daf5b0 --- /dev/null +++ b/es/features.org @@ -0,0 +1,284 @@ +#+title: Características | Org mode +#+setupfile: setup.org +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+include: "resources/preamble.html" export html + +#+begin_export html +<style> + .side-fig img { + filter: invert(1.4%); + box-shadow: none; + max-width: 100%; + } + #content { + max-width: none; + } + body { + padding: 1em 0 0 0; + } + .outline-text-3 p { + padding-bottom: 0.5em; + } + :root { + --body-left: 0 !important; + --body-right: 0 !important; + } +</style> + +<script type="text/javascript" async src="../resources/js/org-quotes.js"></script> +<div class="banner slim"> <p id="a-quote"></p> </div> +#+end_export + +* Marcado elegante + :PROPERTIES: + :CUSTOM_ID: markup + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :style max-height:12em; :alt Ejemplo de un documento básico de Org mostrando los elementos textuales más importantes +[[file:resources/img/features/simple-syntax.svg]] + +** Descripción + +Org mode se utiliza de manera habitual para crear y gestionar flujos de trabajo complejos. Esto lo hace mendiante una sintaxis sencilla y elegante que abarca desde un marcado básico hasta la tipografía completa de LaTeX, permitiendo también trabajar tanto con notas de texto plano como con programas escritos de manera literaria. + +Todo lo que necesitas para comenzar se muestra en el ejemplo. + +*** Más + +Más información sobre [[https://orgmode.org/manual/Markup-for-Rich-Contents.html][marcado]] (manual) + +* Edición estructurada@@comment: y Navegación@@ + :PROPERTIES: + :CUSTOM_ID: editing + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Demostración de cómo plegar y desplegar secciones en Org +[[file:resources/img/features/folding.gif]] + +** Descripción + +La estructura fundamental de un documento de Org es un árbol, cuyas secciones anidadas y plegables constituyen su columna vertebral. Es posible plegar y desplegar árboles completos con solo pulsar una tecla --- =tab=. + +Los árboles de Org facilitan una navegación rápida y fluida, además de permitir ocultar información de manera eficaz. Esto ayuda a que puedas concentrarte en tu tarea principal sin perder acceso a los datos que necesites para completarla. + +Controlar la visibilidad de la secciones es solo una pequeña parte de todas las herramientas y comandos de Org para la edición de texto plano. Org mode aprovecha la sintaxis regular de Org para convertir las tareas tediosas en comandos de una sola tecla, permitiéndote así centrarte en el contenido en lugar de en la forma. + +*** Más + +Más información sobre [[https://orgmode.org/manual/Document-Structure.html][la estructura del documento]] (manual) + +* Tablas transparentes + :PROPERTIES: + :CUSTOM_ID: tables + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Manipular tablas con Org, mover filas y columnas y ejecutar fórmulas +[[file:resources/img/features/tables.gif]] + +** Descripción + +Org incluye un editor de tablas muy potente. + +Utiliza =tab= para moverte entre /columnas/ y =return= para moverte entre /filas/. + +El formato se ajusta automáticamente cuando se modifica el contenido de las celdas. + +Es posible importar tablas desde ficheros =.csv= y =.tsv=, o bien directamente desde el contenido del buffer actual, para después exportarlos a cualquier formato compatible con Org. + +Las tablas de Org no son solo vistas estáticas de datos: estas pueden usarse como sistema de [[https://orgmode.org/manual/The-Spreadsheet.html][hojas de cálculo]] con fórmulas, referencias y más, todo con la simplicidad y transparencia del texto plano. + +*** Más + +El [[https://orgmode.org/manual/Built_002din-Table-Editor.html][editor de tablas incorporado]] (manual) + +Org como sistema de [[https://orgmode.org/manual/The-Spreadsheet.html][hojas de cálculo]] (manual) + +Introducción a [[https://orgmode.org/worg/org-tutorials/tables.html][editar tablas]] (Worg) + +Usando [[https://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.html][Org como hoja de cálculo]] (Worg) + +* Código fuente avanzado + :PROPERTIES: + :CUSTOM_ID: babel + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Demostración de Org Babel ejecutando bloques de código +[[file:resources/img/features/babel.gif]] + +** Descripción + +Org ofrece funcionalidades más allá de notebooks computacionales como [[https://jupyter.org/][Jupyter]] y [[https://rmarkdown.rstudio.com/][R Markdown]]. + +# Program your way. +[[https://orgmode.org/worg/org-contrib/babel/][Org babel]] transforma un bloque de código ejecutable en un entorno completo de [[https://es.wikipedia.org/wiki/Programaci%C3%B3n_literaria][programación literaria]], permitiéndote combinar entradas (inputs) y salidas (outputs) de múltiples lenguajes y entornos de computación en varias máquinas dentro de un único sistema unificado. Esto te da la posibilidad de alcanzar nuevos niveles de [[https://es.wikipedia.org/wiki/No_te_repitas][DRYness]] sin importar si los lenguajes que usas lo facilitan o no. + +# Free your code +Org facilita la extracción de código fuente y la generación de documentación desde un mismo fichero. Aunque muchos lenguajes permiten generar documentación para profesionales de software a partir de comentarios en el código, con Org tu guía de desarrollo y tu manual de uso también pueden ser el código fuente para la implementación y las pruebas, teniendo así una única fuente de verdad que nunca se desincroniza. + +# Emacs. We will add your technological distinctiveness to our own. +Actualmente, Org es compatible con más de [[https://orgmode.org/worg/org-contrib/babel/languages/index.html][80 lenguajes]], y proyectos como [[https://github.com/nnicandro/emacs-jupyter#org-mode-source-blocks][emacs-jupyter]] permiten aprovechar el ecosistema de kernel Jupyter para acceder a aún más lenguajes. + +*** Más + +[[https://orgmode.org/manual/Working-with-Source-Code.html][Trabajando con código fuente]] (manual) + +Lista de [[https://orgmode.org/worg/org-contrib/babel/languages/index.html][lenguajes compatibles]] (Worg) + +* Exportar y publicar + :PROPERTIES: + :CUSTOM_ID: publishing + :HTML_CONTAINER_CLASS: side-fig + :END: +# Powerful publishing + +#+attr_html: :class main-image :alt Muestra un fichero de Org siendo exportado a HTML, markdown, PDF y texto plano +[[file:resources/img/features/exports.gif]] + +** Descripción + +Org es una herramienta para crear y publicar contenido: puede desempeñar funciones que van desde generador de sitios estáticos hasta un conjunto completo de herramientas para autopublicación. + +Redacta documentos utilizando el intuitivo marcado de Org y luego expórtalos al formato que prefieras. Org es compatible con muchos formatos, incluyendo entre ellos: + +- =HTML= +- $\LaTeX$ +- =ODT= +- ¡y muchos más! + + +Las personas que programan pueden facilmente crear nuevos backends para su formato favorito (consulta la [[https://orgmode.org/worg/dev/org-export-reference.html][documentación de referencia de ox]]). Org también es compatible con [[https://pandoc.org][Pandoc]]. + +Además de exportar ficheros invidivuales, puedes definir proyectos de publicación para varios archivos =.org= junto con sus recursos asociados, destinándolos a uno o varios backends de publicación. + +*** Más + +Un secreto mal guardado es que ¡el sitio web de Org está escrito con Org! + +Más información sobre [[https://orgmode.org/manual/Markup-for-Rich-Contents.html][marcado]] (manual) + +Más información sobre [[https://orgmode.org/manual/Exporting.html][exportación]] (manual) + +Más información sobre [[https://orgmode.org/manual/Publishing.html][publicación]] (manual) + +[[https://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html][Tutorial sobre publicación]] en HTML (Worg) + +[[https://orgmode.org/worg/org-tutorials/org-latex-export.html][Tutorial sobre publicación]] en $\LaTeX$ (Worg) + +* Controlar las tareas + :PROPERTIES: + :CUSTOM_ID: planning + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Demostración de planificación con Org, gestión de una lista de tareas programada +[[file:resources/img/features/planning.gif]] + +** Descripción + +Org es extemadamente competente para planificar tareas, gestionar el tiempo y organizar listas TODO (tareas pendientes). + +Cualquier sección puede ser un elemento TODO. Esto se realiza añadiendo una palabra clave (keyword) como =TODO= o =HOLD= que ayuda a seguir el estado de las tareas. Puedes navegar entre los distintos estados de la tarea con los shortcuts =S-<left>= y =S-<right>=. + +¿Necesitas añadir tus propio conjunto de estados? No hay problema. Org te permite customizarlos para mantener tu propio workflow. + +Org Agenda hace más fácil ver distintas tareas de distintos ficheros en un único lugar. Para esto, lo único que tienes que hacer es añadir una de las palabras claves TODO. Org tiene soporte integrado para prioridad de tareas, fechas límites (deadlines), tareas programadas, etiquetas, cronómetro y más. Agenda puede utilizar todo esto para organizar y priorizar tareas: puede escalar desde una lista simple de TODOs hasta una suite completa de gestión de proyectos, todo ello con marcado de texto simple. + +*** Más + +Más información sobre [[https://orgmode.org/manual/TODO-Items.html][elementos TODO]] (manual) + +Manejo de [[https://orgmode.org/manual/Dates-and-Times.html][fechas y tiempos]] (manual) + +* Agendas accionables + :PROPERTIES: + :CUSTOM_ID: agendas + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Un ejemplo de Org Agenda mostrando varios tipos de palabras clave TODO, prioridades, categorías y tareas programadas. +[[file:resources/img/features/agenda.svg]] + +** Descripción + +Planifica tu día a tu manera con facilidad. + +Con las vistas de agenda (reportes generados desde tus elementos TODO) puedes ver tus tareas de manera diaria, semanal y mensual. + +Incluso con cientos de ficheros =.org= y miles de tareas, agenda te permite centrarte en lo que necesitas hacer y actuar de manera rápida, saltando desde una vista general con toda tu planificación a directamente la propia tarea. + +La agenda que viene por defecto muestra tareas programadas y fechas límites para la semana, proyectos estancados y todos tus elementos TODO pendientes. + +¿No te gusta esta versión que viene por defecto? Org agenda es muy configurable. Puedes personalizar los contenidos de las vistas que vienen por defecto o crear tus propias [[https://orgmode.org/manual/Custom-Agenda-Views.html][vistas personalizadas]]. + +De alguna forma, Org es un lenguaje expresivo que captura los puntos clave de interacción en los diagramas de flujo, simplificando y refinando el proceso de desarrollar nuevos diagramas que surgen durante el curso del trabajo, juego o la vida en general. + +*** Más + +Más información en [[https://orgmode.org/manual/Agenda-Views.html][vistas de agenda]] (manual) + +Tutorial sobre [[https://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.html][comandos de agenda]] (Worg) + +* Cronometrar + :PROPERTIES: + :CUSTOM_ID: clocking + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Usando Org para guardar información sobre el tiempo que llevó realizar algunas subtareas +[[file:resources/img/features/clocking.svg]] + +** Descripción + +Puedes llevar un registro del tiempo que has dedicado en tus tareas con Org /Clocking/. Al final del día, también puedes generar informes personalizados sobre cómo has distribuido tu tiempo. + +Org tiene atajos (shortcuts) para registrar la /entrada/ y /salida/ de tareas. Al trabajar en un fichero =.org=, =C-c C-x C-i= registra la entrada y =C-c C-x C-o= la salida. El tiempo se almacena en el cajón de propiedades del encabezado de la tarea correspondiente. + +También puedes usar =I= y =O= desde la vista de agenda. + +*** Más + +Más información en [[https://orgmode.org/manual/Clocking-Work-Time.html][tareas cronometradas]] (manual) + +* Capturar datos desde cualquier parte + :PROPERTIES: + :CUSTOM_ID: capturing + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Usando Org Capture para grabar una idea mientras se edita un fichero +[[file:resources/img/features/capturing.gif]] + +** Descripción + +Puedes añadir contenido a un fichero =.org= capturando datos. + +Puedes capturar desde cualquier parte: desde un buffer de Emacs o desde otra aplicación como tu navegador web, tu visualizador de PDF y más. + +Las plantillas de captura ofrecen una manera rápida y efectiva de ingresar datos estructurados para una variedad de diagramas de flujo, desde añadir elementos TODO hasta citar la sección relevante de un manual o guardar un recibo. + +*** Más + +Más información sobre [[https://orgmode.org/manual/Capture.html][capturing]] (manual) + +* Extremadamente extensible + :PROPERTIES: + :CUSTOM_ID: extensibiliy + :HTML_CONTAINER_CLASS: side-fig + :END: + +#+attr_html: :class main-image :alt Muestra de algunos tipos de enlaces de Org, tanto personalizados como algunos de los que se incluyen por defecto +[[file:resources/img/features/links.svg]] + +** Descripción + +Org mode no es solo extensible, es Emacs-extensible. + +Org comenzó como una extensión. Como resultado de esto, casi todos los aspectos de Org son extensibles. + +Por dar un único ejemplo, piensa en los hyperlinks. Cuando actualizas documentación puedes encontrarte en repetidas ocasiones haciendo enlaces a issues de Github. En Org puedes añadir un nuevo enlace de tipo ~issue:~ al documento de tal forma que ~[[issue:74][big bug]]~ se expanda como =https://github.com/author/repo/issues/74=. + +Más allá de expandir enlaces, puedes definir funciones de resolución personalizadas, hacer enlaces a ficheros en máquinas remotas con [[https://www.emacswiki.org/emacs/TrampMode][Tramp]], y más. diff --git a/es/index.org b/es/index.org new file mode 100644 index 0000000..cc9ac82 --- /dev/null +++ b/es/index.org @@ -0,0 +1,301 @@ +#+title: Org mode para GNU Emacs +#+setupfile: setup.org +#+language: es +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+html_head: <link rel="stylesheet" href="../resources/style/index.min.css" type="text/css" /> +#+html_head: <link rel="preload" href="../resources/img/org-mode-unicorn.svg" as="image" type="image/svg+xml"> +#+include: "resources/preamble.html" export html +#+html_head: <link rel="stylesheet" href="resources/style/org-demo.min.css" type="text/css" /> +#+include: "resources/normal-outline-3.html" export html +#+options: ^:{} + +#+begin_export html +<div class="banner hero" itemscope itemtype="https://schema.org/SoftwareApplication";> + <img src="resources/img/org-mode-unicorn.svg" + alt="Logo del unicornio de Org" itemprop="image"/> + <div> + <h2> + <span itemprop="name">Org Mode</span> + <p class="subtitle">Tu vida en texto plano</p> + </h2> + <p> + Un modo principal de <a href="https://www.gnu.org/software/emacs/"; style="color: inherit; font-weight: bold; font-style: italic;" + title="Un editor de texto extensible, personalizable y libre">GNU Emacs</a> + para <span itemprop="applicationCategory">guardar notas, crear documentos y notebooks computacionales, escribir programación literaria, mantener listas de tareas, planificar proyectos y ¡mucho más! — en un sistema de texto plano rápido y efectivo.</p> + <p><a title="Instalar desde GNU ELPA" href="https://elpa.gnu.org/packages/org.html";><img src="https://elpa.gnu.org/packages/org.svg"; alt="Instalar desde GNU ELPA" /></a> + <a title="Cómo reportar un error" href="/manual/Feedback.html"><img src="resources/img/badge-report-bug.svg" alt="Cómo reportar un error" /></a> + <a title="Escribe un correo electrónico al correo principal de Org-mode" href="mailto:[email protected]"><img src="resources/img/badge-feedback.svg" alt="Escribe un correo electrónico al correo principal de Org-mode" /></a> + <a title="Código fuente" href="https://cgit.git.savannah.nongnu.org/cgit/org-mode.git/";><img src="resources/img/badge-source-code.svg" alt="Código fuente" /></a> + <a title="Código fuente (espejo)" href="https://git.sr.ht/~bzg/org-mode";><img src="resources/img/badge-source-code-mirror.svg" alt="Código fuente (espejo)" /></a> + <a title="Página web del proyecto sr.ht" href="https://sr.ht/~bzg/org";><img src="resources/img/badge-srht-project.svg" alt="Página web del proyecto sr.ht"/></a> + <a title="Canal IRC #org-mode" href="https://web.libera.chat/#org-mode";><img src="resources/img/badge-irc.svg" alt="Canal IRC #org-mode"/></a> + <a title="Sala Matrix #org-mode" href="https://matrix.to/#/%23org-mode:matrix.org";><img src="resources/img/badge-matrix.svg" alt="Sala Matrix #org-mode"/></a></p> + <p><span style="color: #567b70;font-family: var(--sans);font-size: 0.9em;">Código fuente</span><br> + <span style="font-size: 0.9em;"><code>git clone https://git.savannah.nongnu.org/git/org-mode.git</code></span></p><br> + <p><span style="color: #567b70;font-family: var(--sans);font-size: 0.9em;">Código fuente (espejo)</span><br> + <span style="font-size: 0.9em;"><code>git clone https://git.sr.ht/~bzg/org-mode</code></span></p> + <p class="bubble"> + Ayúdanos a crecer via <a href="https://liberapay.com/org-mode"; title="Las donaciones siempre ayudan" + style="font-weight: bold; display: inline-block"> + <img class="inline" src="resources/img/external/librepay.svg" alt="Liberapay logo"/> + Liberapay</a></p> + <meta itemprop="operatingSystem" content="Linux, MacOS, Windows"> + <meta itemprop="softwareVersion" content="9.3.8"> + <meta itemprop="datePublished" content="2020-08-07"> + <meta itemprop="url" content="https://orgmode.org";> + </div> +</div> +<div class="banner slim grey faded inline"> + <p style="width:90vw; color:#515151"> + Creado por + <a target="new" href="https://staff.science.uva.nl/~dominik/"; + style="font-weight:500; color:inherit">Carsten Dominik</a> + en <a target="new" href="../manual/History-and-Acknowledgments.html" style="color:#6e6e6e">2003</a>, + mantenido por <a target="new" href="https://fosstodon.org/@yantar92"; style="font-weight:500; color:inherit">Ihor Radchenko</a> + y desarrollado por + <a href="../org.html#History-and-Acknowledgments" style="color:#6e6e6e">muchas personas más</a>.</p> +</div> +#+end_export + +* Puntos destacados + :PROPERTIES: + :HTML_CONTAINER_CLASS: columns no-heading + :END: + +** Características + @@html:<a href="features.html">@@ + #+attr_html: :alt Tres estrellas :title Sumérgete en un mundo de posibilidades + [[file:resources/img/stars.svg]] + + @@html:</a>@@ + +** Instalación + @@html:<a href="../org.html#Installation">@@ + #+attr_html: :alt Flecha apuntando hacia abajo :title ¿A qué estás esperando? + [[file:resources/img/install.svg]] + + @@html:</a>@@ + +** Primeros pasos + @@html:<a href="quickstart.html">@@ + #+attr_html: :alt Cohete despegando :title Comienza a usar Org - ¡no podrás parar! + [[file:resources/img/quickstart.svg]] + + @@html:</a>@@ + +** Contribuye + @@html:<a href="../worg/org-contribute.html">@@ + #+attr_html: :alt Símbolo de una rama de Git :title Sí, hazlo. + [[file:resources/img/contribute.svg]] + + @@html:</a>@@ + +** Móvil/Web + @@html:<a href="tools.html">@@ + #+attr_html: :alt Símbolo de dispositivos :title Úsalo en iOS, Android o dentro del navegador + [[file:resources/img/mobile-web.svg]] + + @@html:</a>@@ + + +* ignorar :ignore: + + #+attr_html: :style margin-top:2rem; + + Org es un formato de archivo de texto plano altamente flexible y estructurado compuesto por apenas unas pocas estructuras simples, pero versátiles. Está diseñado para ser lo [[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][suficientemente simple para principiantes]] sin dejar de ser [[http://howardism.org/Technical/Emacs/literate-devops.html][increíblemente potente para quienes ya tienen experiencia]]. + + Echa un vistazo sobre el poder expresivo que ofrece Org en el ejemplo de abajo. + Haz clic en los encabezados y enlaces para descubrir cómo Org organiza de manera inteligente el contenido estructurado. + También puedes consultar la [[https://orgmode.org/worg/org-syntax.html][especificación formal de la sintaxis de Org]] y [[https://orgmode.org/tools.html][una lista de parseadores de la sintaxis de Org]]. + + #+include: org-demo.html export html + +* Lecturas adicionales + :PROPERTIES: + :CUSTOM_ID: reading + :END: + + A parte de la [[file:quickstart.org][guía rápida]] y el [[https://orgmode.org/org.html][manual]], Org tiene una [[https://orgmode.org/orgguide.html][guía]] y una gran cantidad de documentación escrita por la comunidad en [[https://orgmode.org/worg/][Worg]]. + + Casi todas las personas que usan Org tienen una historia que contar sobre cómo este les permite actuar con mayor autonomía. Algunas personas lo encuentran tan útil que incluso han escrito [[https://orgmode.org/worg/org-papers.html][artículos científicos]] sobre el valor de Org para llevar a cabo [[https://es.wikipedia.org/wiki/Reproducibilidad_y_repetibilidad#Reproducibilidad_en_la_pr%C3%A1ctica_cient%C3%ADfica][investigaciones reproducibles]]. También se han desarrollado herramientas de terceros para disfrutar de Org fuera de Emacs, como aplicaciones móviles. + +* Más sobre Org + :PROPERTIES: + :CUSTOM_ID: more + :END: + +El [[https://orgmode.org/worg/org-media-type.html][mimetype para ficheros Org]] es =text/org=. Los ficheros Org utilizan la extensión ~.org~. La mayoría de los sistemas operativos no saben cómo abrir ficheros ~.org~ en Emacs, pero se pueden configurar para hacerlo sin mucho esfuerzo. + +Aunque la implementación de Org en Emacs lisp es, con diferencia, la más completa en cuanto a funcionalidades, hay muchas otras [[file:tools.org][herramientas]] que funcionan con Org. + +#+begin_center +#+attr_html: :class btn +[[file:tools.org][Herramientas que funcionan con Org]] +#+end_center + +* El pulso del proyecto + +# Retrieve the latest Sacha Chua's Emacs News (Org mode section) +#+name: get-sacha-news +#+begin_src emacs-lisp :eval yes :exports none :results value + (let* ((org-text-buffer + (url-retrieve-synchronously + "https://raw.githubusercontent.com/sachac/emacs-news/master/most-recent.org";)) + (org-data + (with-current-buffer org-text-buffer + ;; https://sachachua.com/blog/2024/05/emacs-url-retrieve-synchronously-and-set-buffer-multibyte/ + (set-buffer-multibyte t) + (org-mode) + (org-element-parse-buffer)))) + (org-element-map org-data '(item) + (lambda (item) + (when-let ((contents (org-element-contents item)) + (paragraph (car contents)) + (paragraph-text (car (org-element-contents paragraph)))) + (when (and (stringp paragraph-text) + (string-equal-ignore-case paragraph-text "Org Mode:\n")) + (cdr contents)))) + nil 'first-match)) +#+end_src + +#+name: get-sacha-news-date + #+begin_src emacs-lisp :eval yes :exports none :results raw value + (let ((org-text-buffer + (url-retrieve-synchronously + "https://raw.githubusercontent.com/sachac/emacs-news/master/most-recent.org";))) + (with-current-buffer org-text-buffer + ;; https://sachachua.com/blog/2024/05/emacs-url-retrieve-synchronously-and-set-buffer-multibyte/ + (set-buffer-multibyte t) + (org-mode) + (goto-char (point-min)) + (search-forward "#+TITLE:") + (let ((keyword (org-element-at-point))) + (when (equal "TITLE" (org-element-property :key keyword)) + (format " (from [[https://sachachua.com/blog/category/emacs-news/][%s]])" + (org-element-property :value keyword)))))) + #+end_src + +# Retrieve data from tracker.orgmode.org +#+name: get-tracker-data +#+begin_src emacs-lisp :eval yes :exports none :results value :var url="https://tracker.orgmode.org/reports/announcements-open.org"; :var limit=6 + (let* ((org-text-buffer + (url-retrieve-synchronously url)) + (org-data + (with-current-buffer org-text-buffer + ;; https://sachachua.com/blog/2024/05/emacs-url-retrieve-synchronously-and-set-buffer-multibyte/ + (set-buffer-multibyte t) + (org-mode) + (org-element-parse-buffer)))) + (mapconcat + #'identity + (take + limit + (org-element-map org-data '(headline) + (lambda (h) + (when-let ((url (org-element-property :ARCHIVED-AT h)) + (title (org-element-property :raw-value h))) + (concat "- " (org-make-link-string url title)))))) + "\n")) +#+end_src + +- Nuevas características: + #+begin_src emacs-lisp :eval yes :exports results :results raw value :noweb yes + (let ((all-news + <<get-sacha-news>> + )) + ;; Keep only "Org development" + (or + (org-element-map all-news '(item) + (lambda (item) + (when-let ((contents (org-element-contents item)) + (paragraph (car contents)) + (paragraph-text (car (org-element-contents paragraph)))) + (when (and (stringp paragraph-text) + (string-equal-ignore-case paragraph-text "Org development:\n")) + (org-element-interpret-data (cdr contents))))) + nil 'first-match) + "<No se han añadido nuevas características a Org mode recientemente>")) + #+end_src +- Anuncios: + #+call: get-tracker-data[:results raw value :eval yes :exports results](url="https://tracker.orgmode.org/reports/announcements-open.org";) +- Discusiones: + #+call: get-tracker-data[:results raw value :eval yes :exports results](url="https://tracker.orgmode.org/reports/requests-open.org";) +- Entradas de blog recientes call_get-sacha-news-date()[:exports results :eval yes]: + #+begin_src emacs-lisp :eval yes :exports results :results raw value :noweb yes + (let ((all-news + <<get-sacha-news>> + )) + ;; Keep all but "Org development" + (org-element-map all-news '(item) + (lambda (item) + (when-let ((contents (org-element-contents item)) + (paragraph (car contents)) + (paragraph-text (car (org-element-contents paragraph)))) + (when (and (stringp paragraph-text) + (string-equal-ignore-case paragraph-text "Org development:\n")) + (org-element-extract item))))) + (org-element-interpret-data (or all-news "<No hay noticias recientes>"))) + #+end_src + +* [[https://orgmode.org/worg/][Worg]], un /mundo/ de Org + :PROPERTIES: + :CUSTOM_ID: worg + :END: + +Org y Org-mode abarcan tantos casos de uso que no resulta posible documentarlos de forma sencilla, y mucho menos mostrarlos todos en una única página. +Como resultado, [[https://orgmode.org/worg/][Worg]] sirve como una wiki comunitaria y ofrece un lugar para documentar y compartir información sobre todos los aspectos del uso y el manejo de Org. + +Por ejemplo, [[https://orgmode.org/worg/][Worg]] contiene: + +- [[https://orgmode.org/worg/org-faq.html][Preguntas frecuentes]] +- [[https://orgmode.org/worg/org-hacks.html][Trucos de Org]] +- [[https://orgmode.org/worg/org-tutorials/index.html][Lista de tutoriales]] +- [[https://orgmode.org/worg/doc.html][Documentación completa de hooks, comandos y opciones]] +- [[https://orgmode.org/worg/org-in-the-wild.html][Org en el mundo real]] +- … ¡y mucho más! + +[[https://orgmode.org/worg/][Worg]] se mantiene como un repositorio Git con archivos Org que son publicados como una página web HTML. Las nuevas [[https://orgmode.org/worg/worg-about.html#contribute-to-worg][contribuciones son bienvenidas]]. + +#+BEGIN_SRC shell +~$ git clone https://git.sr.ht/~bzg/worg +#+END_SRC + +* Unirse a la lista de correo + :PROPERTIES: + :CUSTOM_ID: mailing-list + :END: + +La lista de correo de Org es el lugar principal para conectar con la comunidad de Org. Te puedes [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][suscribir a la lista]] y explorar la lista de archivos en [[https://list.orgmode.org][list.orgmode.org]] o en [[https://lists.gnu.org/archive/html/emacs-orgmode/][esta página de Mailman]]. + +Si no formas parte de la lista de suscripción, puedes enviar un correo a [[mailto:[email protected]][[email protected]]] y te añadiremos al grupo de personas autorizadas que pueden enviar mensajes a la lista. + +Puedes [[https://orgmode.org/worg/org-mailing-list.html][leer más sobre la lista de correo]] y encontrar más información sobre [[https://orgmode.org/worg/org-web-social.html][las novedades de Org en las redes sociales]]. + +También puedes conectar con otras personas fanáticas de Org a través de IRC en ~#org-mode~ en [[https://libera.chat/][Libera.Chat]]. + +La lista completa de [[https://orgmode.org/worg/contributors.html][contribuyentes]] del Org mode se mantiene en Worg y también puedes ver los [[https://orgmode.org/org.html#History-and-Acknowledgments][agradecimientos]] del manual. + +* Doom, Spacemacs, Scimax y configuraciones típicas + :PROPERTIES: + :CUSTOM_ID: configs + :END: + +Los kits de inicio de Emacs [[https://github.com/hlissner/doom-emacs][Doom]], [[https://www.spacemacs.org/][Spacemacs]] y [[https://github.com/jkitchin/scimax][Scimax]] incluyen un conjunto seleccionado de paquetes y configuraciones que buscan mejorar el Org mode (e Emacs en general) para casos de uso específicos. Incluyen Org junto con integraciones entre =org-mode= y otros modos (como =evil-mode=). + +Se incluyen a continuación los enlaces a los paquetes incluídos en [[https://github.com/hlissner/doom-emacs/blob/develop/modules/lang/org/packages.el][Doom]] y [[https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bemacs/org/packages.el][Spacemacs]]. Scimac está profundamente integrado con Org, por lo que un buen punto de partida es el [[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][manual]]. Doom instala una versión de Org muy próxima al ~HEAD~ de desarrollo, mientras que Spacemacs y Scimax siguen org elpa. + +Los kits de inicio suelen hacer cambios significativos en la experiencia de quién usa Org con Emacs. Si estás buscando algo más cercano a la versión original de Emacs, existen configuraciones populares como [[https://github.com/purcell/emacs.d/blob/master/lisp/init-org.el][Purcell's emacs.d]] que incluyen personalizaciones del Org mode y paquetes relacionados con paquetes de Org. + +* En otros editores, Android, iOS + :PROPERTIES: + :CUSTOM_ID: editors + :END: + +Si bien el conjunto de [[file:features.html][características]] de Org es actualmente exclusivo de Emacs, la funcionalidad básica para archivos Org ha sido implementada para una variedad de editores y aplicaciones móviles. A continuación se encuentran algunas extensiones y aplicaciones que permiten trabajar con ficheros Org: + +- *Vim* : [[https://github.com/kristijanhusak/orgmode.nvim][orgmode.nvim]], [[https://github.com/jceb/vim-orgmode][vim-orgmode]], and [[https://github.com/axvr/org.vim][org.vim]] +- *VS Codium* : [[https://github.com/vscode-org-mode/vscode-org-mode][vscode-org-mode]] +- *Android* : [[https://www.orgzlyrevived.com/][Orgzly Revived]], [[https://orgro.org/][Orgro]], [[https://github.com/Artawower/orgnote][Org Note]] +- *iOS* : [[https://mobileorg.github.io/features/][MobileOrg]], [[https://orgro.org/][Orgro]] +- *Web* : [[https://organice.200ok.ch/][Organice (progressive web app)]], [[https://github.com/Artawower/orgnote][Org Note]] + diff --git a/es/manuals.org b/es/manuals.org new file mode 100644 index 0000000..c29eac1 --- /dev/null +++ b/es/manuals.org @@ -0,0 +1,32 @@ +#+title: Manuales | Org mode +#+setupfile: setup.org +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+include: "./resources/preamble.html" export html + +* Manual Org + +El manual de Org es el recurso completo y oficial para las funciones del núcleo de Org. + +- Como [[https://orgmode.org/org.html][una única página HTML]] +- Como [[https://orgmode.org/manual/][varias páginas HTML]] +- Como [[https://orgmode.org/org.pdf][un documento PDF]] + +* Guía compacta de Org + +La guía compacta de Org Mode es una pequeña introducción a las principales características de Org Mode. + +- Como [[https://orgmode.org/orgguide.html][una única página HTML]] +- Como [[https://orgmode.org/guide/][varias páginas HTML]] +- Como [[https://orgmode.org/orgguide.pdf][un documento PDF]] + +* Worg: la documentación escrita por la comunidad + +- Como [[https://orgmode.org/worg/][HTML]] +- Como repositorio Git: =~$ git clone https://git.sr.ht/~bzg/worg= +- [[https://orgmode.org/worg/worg-about.html][Sobre Worg]]: ¿cómo contribuir? + +* Manual de Org para la versión GNU Emacs + +GNU Emacs publica manuales con sus componentes. Org está distribuído con GNU Emacs. + +Puedes acceder al [[https://www.gnu.org/software/emacs/manual/org.html][manual de Org GNU Emacs aquí]]. diff --git a/es/org-demo.html b/es/org-demo.html new file mode 100644 index 0000000..fbc0277 --- /dev/null +++ b/es/org-demo.html @@ -0,0 +1,132 @@ +<div id="org-demo" style="counter-set: chk 0"> + <asside class="label-left">Metadatos</asside> + <pre class="label-left"> +#+title: <span class="org-document-title">Example Org File</span> +#+author: <span class="org-document-info">TEC</span> +#+date: <span class="org-document-info">2020-10-27</span></pre> + <details open> + <summary> + <asside class="right" style="position: relative; z-index: -1"> + <h4>Esquema</h4> <!-- TODO: I don't know if this is the best way to phrase it --> + Los encabezados y el plegado hacen que la edición estructurada sea pan comido. + El texto plano facilita sincronizar y llevar el control de versiones de los ficheros Org. + </asside> + <pre><span class="org-level-1">* Revamp orgmode.org website</span></pre> + </summary> + <asside class="left"> + <h4>Agenda</h4> + Lista las tareas pendientes de todos tus ficheros. + Filtra el contenido y actualízalo sobre la marcha. + </asside> + <pre> + +The <i>/beauty/</i> of org <b>*must*</b> be shared.</pre> + <details class="replace"> + <summary> + <pre><span class="org-link">[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]</span></pre> + </summary> + <img src="https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg"; alt="share icon" style="height: 3em; margin-left: 1.5em"/> + </details> + <details open class="br"> + <summary> + <pre><span class="org-level-2">** <span class="org-done">DONE Make screenshots</span></span></pre> + </summary> + <pre> <span class="org-special-keyword">CLOSED:</span> <span class="org-date">[2020-09-03 Thu 18:24]</span> + +</pre> + </details> + <details open> + <summary> + <pre><span class="org-level-2">** <span class="org-done">DONE Restyle Site CSS</span></span></pre> + </summary> + <pre> + +Go through <span class="org-link"><a href="/resources/style/org.css">[[file:style.scss][stylesheet]]</a></span> + +</pre> + </details> + <input type="checkbox" class="chk" id="chk1" checked /> + <input type="checkbox" class="chk" id="chk2" checked /> + <input type="checkbox" class="chk extra" id="chk3" /> + <input type="checkbox" class="chk" id="chk4" /> + <input type="checkbox" class="chk" id="chk5" checked /> + <input type="checkbox" class="chk extra" id="chk6" /> + <input type="checkbox" class="chk" id="chk7" /> + <details> + <summary> + <pre><span class="org-level-2">** <span class="org-todo">TODO</span> Check CSS on main pages <span class="count-res"></span></span></pre> + </summary> + <pre class="countme"> + +<label for="chk1"><span class="org-list-dt">-</span> Index page</label> +<label for="chk2"><span class="org-list-dt">-</span> Quickstart</label> +<label for="chk3"><span class="org-list-dt">-</span> Features</label> +<label for="chk4"><span class="org-list-dt">-</span> Releases</label> +<label for="chk5"><span class="org-list-dt">-</span> Install</label> +<label for="chk6"><span class="org-list-dt">-</span> Manual</label> +<label for="chk7"><span class="org-list-dt">-</span> Contribute</label> +</pre> + </details> + </details> + <details open class="label-left"> + <summary> + <asside class="label-left">Prosa</asside> + <pre><span class="org-level-1">* Learn Org</span></pre> + </summary> + <pre> + +Org makes easy things trivial and complex things practical. + +You don't need to learn Org before using Org: read the quickstart +page and you should be good to go. If you need more, Org will be +here for you as well: dive into the manual and join the community! + </pre> + <details open> + <summary> + <pre><span class="org-level-2">** Feedback</span></pre> + </summary> + <pre> + +<span class="org-special-keyword">#+include: "other/feedback.org*manual" :only-contents t</span></pre> + </details> + </details> + <details open> + <summary> + <pre> +<span class="org-level-1">* Revisar las proporciones de minificación de CSS</span> + </pre> + </summary> + <asside class="right"> + <h4>Babel</h4> + Realizar programación literaria en Org, + con ejecución de código en vivo dentro del buffer, al estilo de un cuaderno. + </asside> + <asside class="label-left">Código</asside> + <details open> + <summary><pre class="label-left" style="background-color: #ccc4"><span class="org-block-begin-line">#+begin_src python</span></pre></summary> + <pre class="src label-left" style="background-color: #fff4"> +<span class="org-keyword">from</span> pathlib <span class="org-keyword">import</span> Path +<span class="org-variable-name">cssRatios</span> = [] +<span class="org-keyword">for</span> css_min <span class="org-keyword">in</span> Path(<span class="org-string">"resources/style"</span>).glob(<span class="org-string">"*.min.css"</span>): + <span class="org-variable-name">css</span> = css_min.with_suffix(<span class="org-string">''</span>).with_suffix(<span class="org-string">'.css'</span>) + cssRatios.append([css.name, + <span class="org-string">"{:.0f}% minified ({:4.1f} KiB)"</span>.<span class="org-builtin">format</span>( <b>100</b> * + css_min.stat().st_size / css.stat().st_size, + css_min.stat().st_size / <b>1000</b>)]) +<span class="org-keyword">return</span> cssRatios +</pre> + <pre class="label-left" style="background-color: #ccc4"><span class="org-block-end-line">#+end_src</span></pre> + </details> + <details open> + <summary> + <asside class="label-left">Resultados evaluados</asside> + <pre class="label-left br"><span class="org-block-begin-line">#+RESULTS:</span></pre> + </summary> + <pre class="label-left"><span class="org-table">| index.css | 76% minified ( 1.4 KiB) | +| org-demo.css | 77% minified ( 2.8 KiB) | +| errors.css | 74% minified ( 4.9 KiB) | +| org.css | 75% minified (10.7 KiB) | +</span></pre> + </details> + </details> +</div> diff --git a/es/quickstart.org b/es/quickstart.org new file mode 100644 index 0000000..2a426f5 --- /dev/null +++ b/es/quickstart.org @@ -0,0 +1,261 @@ +#+TITLE: Guía de inicio rápido | Org mode +#+setupfile: setup.org +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+include: "resources/preamble.html" export html + +* Comenzando con Org-mode + :PROPERTIES: + :CUSTOM_ID: getting-started + :END: + +En su forma más simple, Org es como otro lenguaje de marcado cualquiera. + +Puedes escribir [[https://orgmode.org/worg/dev/org-syntax.html][sintaxis Org]] en cualquier editor de texto. + +Sin embargo, para experienciar el potencial completo de Org necesitar un editor que transforme la sintaxis de Org en un documento vivo e interactivo. + +#+begin_center +#+attr_html: :class btn +*[[file:../org.html#Installation][Instalar Org]]* +#+end_center + +* Preámbulo + :PROPERTIES: + :CUSTOM_ID: preamble + :END: + +Al comienzo de un fichero (antes de su primer encabezado), el común señalizar el título, el autor y otras [[https://orgmode.org/manual/Export-Settings.html][opciones de exportación]]. + +#+BEGIN_SRC org +,#+title: Las glorias de Org +,#+author: A. Escritor de Org +#+END_SRC + +* Encabezados + :PROPERTIES: + :CUSTOM_ID: headings + :END: + +Las líneas que comienzan con un asterisco ~*~ son [[https://orgmode.org/worg/dev/org-syntax.html#Headlines_and_Sections][encabezados]]. + +Un único ~*~ denota un primer nivel de encabezado, ~**~ denota un segundo nivel de encabezado, etc. + +#+BEGIN_SRC org +,* Te doy la bienvenida a Org-mode +,** Segundo encabezado +Cada ~*~ extra aumenta la profundidad en un nivel. +#+END_SRC + +En su manera más simple, los encabezados son solo el comienzo de secciones. Sin embargo, cualquier encabezado se puede transformar en un [[https://orgmode.org/manual/TODO-Items.html][elemento TODO]]. + +Los elementos TODO son los constructores más básicos que Org utiliza para dar seguimiento y organizar todo tipo de tareas. + +Para añadir un elemento TODO a un encabezado, comienza este con una palabra clave TODO como ~TODO~ o ~HOLD~. + +#+BEGIN_SRC org +,* TODO Promulgar Org al mundo +,** TODO Crear una guía de inicio rápido +#+END_SRC + +* Marcado + :PROPERTIES: + :CUSTOM_ID: markup + :END: + +Para marcar texto en Org, simplemente rodealo con uno o más carácteres marcadores. Las marcaciones en *negrita*, /cursiva/ and _subrayado_ son muy intuitivas, y el +tachado+ es ya de un nivel un poco más elevado. También puedes _/*combinar*/_ la marcación básica en cualquier orden, sin embargo, ~code~ y =verbatim= tienen que ser los marcadores *_~más internos~_* si están presentes ya que sus contenidos se interpretan =_literalmente_=. + +#+begin_example +Para marcar texto en Org, simplemente rodealo con uno o más carácteres marcadores. Las marcaciones en *negrita*, /cursiva/ and _subrayado_ son muy intuitivas, y el +tachado+ es ya de un nivel un poco más elevado. También puedes _/*combinar*/_ la marcación básica en cualquier orden, sin embargo, ~code~ y =verbatim= tienen que ser los marcadores *_~más internos~_* si están presentes ya que sus contenidos se interpretan =_literalmente_=. +#+end_example + +Para más detalles, vea [[https://orgmode.org/worg/dev/org-syntax.html#Emphasis_Markers][Marcadores enfáticos]]. + +* Listas + :PROPERTIES: + :CUSTOM_ID: lists + :END: + +Las listas no ordenadas comienzan por ~+~, ~-~, o ~*~[fn::~*~ no puede utilizarse para comenzar una lista simple si está inmediatamente precedido por un salto de línea porque esto se interpretaría como un encabezado.]. Las listas ordenadas comienzan por ~1.~, ~1)~, ~A.~, o ~A)~. Las listas ordenadas y no ordenadas pueden anidarse en cualquier orden. + +#+BEGIN_SRC org + Comprar: + 1. Leche + 2. Huevos + - Ecológicos + 3. Queso + + Parmesano + + Mozzarella +#+END_SRC + +Las listas pueden contener cuadros de marcado (checkboxes) ~[ ]~, ~[-]~, ~[X]~. +#+BEGIN_SRC org +- [ ] no empezado +- [-] en progreso +- [X] complete +#+END_SRC + +Las listas pueden contener tags (y cuadros de marcado al mismo tiempo). +#+BEGIN_SRC org +- [ ] frutas :: conseguir manzanas +- [X] veganos :: conseguir zanahorias +#+END_SRC + +* Enlaces + :PROPERTIES: + :CUSTOM_ID: links + :END: + +Para crear un enlace, coloca el destino (/target/) entre dos corchetes: ~[[target]]~. + +Puedes incluir una descripción entre corchetes después del destino: ~[[target][desc]]~. + +El orden es fácil de recordar porque es el mismo que en una etiqueta HTML =<a>= (~<a href="target">desc</a>~) y no puedes confundir corches con paréntesis porque ¡solo hay corchetes cuadrados! + +Org admite una gran variedad de tipos de destino de enlace y también puedes [[https://orgmode.org/manual/Adding-Hyperlink-Types.html][añadir los tuyos propios]]. + +Los tipos de enlace se indican con un prefijo ~type:~ prefix, i.e., ~[type:target]~. +Si no se proporciona ~type:~, Org busca en el archivo actual un encabezado que coincida con ~target~. + +Algunos ejemplos: +#+BEGIN_EXAMPLE +[[https://orgmode.org][una página web muy chula]] +[[file:~/Pictures/dank-meme.png]] +[[earlier heading][un primer encabezado en el documento]] +#+END_EXAMPLE + +** Más información +Para más información sobre los enlaces, vea la secciones del manual para +[[https://orgmode.org/manual/Internal-Links.html][Enlaces Internos]] y [[https://orgmode.org/manual/External-Links.html][Enlaces Externos]]. + +* Imágenes + :CUSTOM_ID: images + :END: + +Org mode reconoce y muestra de manera autómatica los enlaces a imágenes durante la exportación. Solo enlaza la imagen (no incluyas una descripción). Eso es todo \\ +~[[https://upload.wikimedia.org/wikipedia/commons/5/5d/Konigsberg_bridges.png]]~ + +#+attr_html: :height 120px +[[https://upload.wikimedia.org/wikipedia/commons/5/5d/Konigsberg_bridges.png]] + +Las imágenes guardadas en tu ordenador también se pueden mostrar en el buffer de Emacs con =C-c C-x C-v=. + +* Bloques + :PROPERTIES: + :CUSTOM_ID: blocks + :END: + + +Org utiliza bloques =#+BEGIN= ... =#+END= para diferentes propósitos. +Algunos de los tipos básicos de bloques son citado (quote), ejemplo (example) y src. + +Si lo que necesitas es un texto monoespaciado, puedes utilizar un bloque de ejemplo. +#+BEGIN_SRC org +,#+begin_example +monoespacio +,#+end_example +#+END_SRC + +Sin embargo, los bloques de ejemplo no te dan el poder de [[https://orgmode.org/worg/org-contrib/babel/][Org babel]]. +Para esto necesitas un bloque de fuente (source) +Los bloques de fuente ofrecen sintáxis destacada, ejecución de código, programación literaria y mucho más. +#+BEGIN_SRC org +,#+begin_src emacs-lisp +(message "Hola mundo") +,#+end_src +#+END_SRC + +** Más información +Un ejemplo de "Hola mundo" no puede ni siquiera empezar a rozar la magnitud del soporte de Org para [[https://orgmode.org/manual/Working-with-Source-Code.html][trabajar con código fuente]]. + +* Tablas + :PROPERTIES: + :CUSTOM_ID: tables + :END: +Org mode incluye un editor de tablas completo que permite referencias entre celdas y fórmulas. + +En su forma más simple, una tabla es un texto separado por barras verticales ~|~. + +#+BEGIN_SRC org +| Yo | soy | una | tabla | +| con | dos | filas | ! | +#+END_SRC + +Un ejemplo mucho más útil es esta comparación de las herramientas existentes de programación literaria/investigación reproducible ([[doi:10.18637/jss.v046.i03][Schulte /et al./ 2012]]). + +#+BEGIN_SRC org +| Tool | Literate programming? | Reproducible Research? | Languages | +|--------------+-----------------------+------------------------+-----------| +| Javadoc | partial | no | Java | +| Haskell .lhs | partial | no | Haskell | +| noweb | yes | no | any | +| Sweave | partial | yes | R | +| Org-mode | yes | yes | any | +#+END_SRC + +¿Te preocupa alinear tablas de texto libre? +Org mode lo hace con una sola pulsación de la tecla =tab=. + +* Commentarios + :PROPERTIES: + :CUSTOM_ID: comments + :END: + +Org mode tiene distintas formas de añadir comentarios. + +- Los comentarios en una línea comienzan por ~#~. +- Los comentarios dentro de una línea se realizan entre arrobas, ~@@comment:como este@@~. +- Los comentarios en bloque se realizan entre ~#+BEGIN_COMMENT~ y ~#+END_COMMENT~. +- Los comentarios en secciones se pueden crear añadiendo la palabra clave ~COMMENT~ al encabezado ~* + COMMENT como este~[fn::Hay formas más detalladas de controlar el comportamiento exacto de los encabezados, incluyendo el uso de las tags especiales ~:ARCHIVE:~ y + ~:noexport:~.]. + +#+BEGIN_SRC org + # A line comment + +Ejemplo de un comentario @@comment:dentro de una línea@@. + +Los comentarios dentro de una línea se utilizan para terminar una línea de comentario. @@comment:~#~ no funcionará@@ ya que # solo funciona si va precedido de una nueva línea seguida de un espacio en blanco. + + ,#+begin_comment + +Esto es un comentario en bloque. +Se puede partir en distintas líneas. +Al igual que los otros marcadores. +,#+begin_src emacs-lisp +(+ 1 2) +,#+end_src +,#+end_comment + +,* Un encabezado de alto nivel +,** COMMENT Esta sección y subseciones están comentadas +,*** Este encabezado hereda la palabra clave =COMMENT= +Este texto está comentado fuera +,** Este encabezado no está comentado +Este texto será exportado y el bloque de código se ejecutará. +#+END_SRC + +* Macros + :PROPERTIES: + :CUSTOM_ID: macros + :END: + +Org tiene muchas más funciones avanzadas integradas en su sintaxis. Por dar un solo ejemplo, veamos [[https://orgmode.org/manual/Macro-Replacement.html][macros]]. +#+BEGIN_SRC org +,#+macro: attn _*/$1/*_ +{{{attn(¡Atención! ¡Este texto recibe todo el marcado!)}}} + +,#+html_head: <style>.red{color:red;}</style> +,#+latex_header: \usepackage{xcolor} +,#+macro: red @@html:<span class="red">$1</span>@@@@latex:\textcolor{red}{$1}@@ +Texto normal. {{{red(Este texto estará de color rojo.)}}} Más texto normal. +#+END_SRC + +* Siguientes pasos + :PROPERTIES: + :CUSTOM_ID: next-steps + :END: + +¿Estás buscando algo en particular? El [[file:../manual/][manual]] ([[file:../org.pdf][PDF]]) es un buen lugar por el que empezar. + +¿Estás buscando algo entre una guía rápida y el manual? La +[[file:../guide/][guía]] ([[file:../orgguide.pdf][PDF]]) merece la pena. diff --git a/es/resources/fonts b/es/resources/fonts new file mode 120000 index 0000000..db461b9 --- /dev/null +++ b/es/resources/fonts @@ -0,0 +1 @@ +../../resources/fonts \ No newline at end of file diff --git a/es/resources/img b/es/resources/img new file mode 120000 index 0000000..a3dbcb6 --- /dev/null +++ b/es/resources/img @@ -0,0 +1 @@ +../../resources/img \ No newline at end of file diff --git a/es/resources/js b/es/resources/js new file mode 120000 index 0000000..abe6c55 --- /dev/null +++ b/es/resources/js @@ -0,0 +1 @@ +../../resources/js \ No newline at end of file diff --git a/es/resources/normal-outline-3.html b/es/resources/normal-outline-3.html new file mode 120000 index 0000000..2c53e57 --- /dev/null +++ b/es/resources/normal-outline-3.html @@ -0,0 +1 @@ +../../resources/normal-outline-3.html \ No newline at end of file diff --git a/es/resources/oembed-info.json b/es/resources/oembed-info.json new file mode 120000 index 0000000..650c2c9 --- /dev/null +++ b/es/resources/oembed-info.json @@ -0,0 +1 @@ +../../resources/oembed-info.json \ No newline at end of file diff --git a/es/resources/postamble.html b/es/resources/postamble.html new file mode 100644 index 0000000..51f2748 --- /dev/null +++ b/es/resources/postamble.html @@ -0,0 +1,17 @@ +<p class="author">Creado por + <a href="https://github.com/tecosaur/"; + style="font-weight: bold; font-size: 0.9em; letter-spacing: 0.05em" + title="Your friendly neighbourhood Org-thusiast">TEC</a> + con + <a href="https://orgmode.org/worg/org-site-colophon.html";> + <img class="inline" src="/resources/img/org-mode-unicorn-borderless-icon.svg" alt="Logo del unicornio de Org mode" + style="height:1.5em; margin-bottom:-0.3em; opacity:0.9;" + title="Conquer the world with Org 😉"/> + </a> +</p> +<p class="license-text" style="color: #aaa">con licencia + <a rel="license" href="https://git.sr.ht/~bzg/orgweb/blob/master/LICENSE.org"; + style="font-size: 0.8em; letter-spacing: 0.1em; font-weight: bold; color: inherit" + title="GNU Free Documentation License version 1.3">GNU FDL 1.3</a>. + Consulta el <a href="https://git.sr.ht/~bzg/orgweb";>código fuente</a> de esta web. +</p> diff --git a/es/resources/preamble.html b/es/resources/preamble.html new file mode 100644 index 0000000..6a606f5 --- /dev/null +++ b/es/resources/preamble.html @@ -0,0 +1,25 @@ +<!-- <script type="text/javascript" async src="/resources/js/org.js"></script> --> + +<nav id="main"> + <label for="hamburger">☰</label> + <input type="checkbox" id="hamburger"/> + + <span id="translate"> + [ <a title="English version" href="../index.html">en</a> + - <a title="Versión en español" href="index.html">es</a> + - <a title="Version française" href="/fr/index.html">fr</a> + - <a title="Japanese version" href="/ja/index.html">ja</a> + - <a title="简体中文版本" href="/zh-CN/index.html">简</a> + ] + </span> + <a href="."> + <p class="logo"><img src="../resources/img/org-mode-unicorn.svg" alt="Logo de Org Mode"/>Org Mode</p></a> + <a href="features.html">Características</a> + <a title="Obtén actualizaciones detalladas sobre las últimas versiones" href="Changes.html">Versiones</a> + <a title="Consulta los próximos cambios, solicitudes de ayuda, errores confirmados y parches enviados" href="https://updates.orgmode.org";>Actualizaciones</a> + <a title="Comienza aquí para instalar Org" href="https://orgmode.org/org.html#Installation";>Instalación</a> + <a title="Consulta todos los manuales" href="manuals.html">Manuales</a> + <a title="Worg es la documentación comunitaria de Org" href="https://orgmode.org/worg/";>Worg</a> + <a title="Comienza aquí si quieres contribuir a Org" href="https://orgmode.org/worg/org-contribute.html";>Contribuir</a> + <a title="Herramientas que funcionan con Org" href="tools.html">Herramientas</a> +</nav> diff --git a/es/resources/style b/es/resources/style new file mode 120000 index 0000000..d2c0a04 --- /dev/null +++ b/es/resources/style @@ -0,0 +1 @@ +../../resources/style \ No newline at end of file diff --git a/es/setup.org b/es/setup.org new file mode 100644 index 0000000..eab50bd --- /dev/null +++ b/es/setup.org @@ -0,0 +1,32 @@ +#+language: es +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+startup: hidestars +#+options: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:t *:t TeX:t author:nil <:t LaTeX:t +#+property: header-args :eval no-export +#+html_head: <meta name="theme-color" content="#77aa99"> +#+html_head: <meta property="og:title" content="Org Mode"> +#+html_head: <meta property="og:type" content="website"> +#+html_head: <meta property="og:url" content="https://orgmode.org";> +#+html_head: <meta property="og:image" content="https://orgmode.org/resources/img/social-card.png";> +#+html_head: <meta property="og:image:alt" content="Org-mode. Complex so you don't have to be. A versatile organisationay system with immense capabilities."> +#+html_head: <meta property="og:image:type" content="image/svg"> +#+html_head: <meta property="og:image:width" content="1280"> +#+html_head: <meta property="og:image:height" content="640"> +#+html_head: <meta property="og:description" content="Org-mode. Complex so you don't have to be. A versatile organisational system with immense capabilities."> +#+html_head: <meta property="twitter:card" content="summary_large_image"> +#+html_head: <meta property="twitter:url" content="https://orgmode.org";> +#+html_head: <meta property="twitter:title" content="Org Mode"> +#+html_head: <meta property="twitter:description" content="Org: an Emacs Mode for Notes, Planning, Authoring and more!"> +#+html_head: <meta property="twitter:image" content="https://orgmode.org/resources/img/social-card.png";> +#+html_head: <meta property="twitter:image:alt" content="Org-mode. Complex so you don't have to be. A versatile organisationay system with immense capabilities."> +#+html_head: <link rel="alternate" type="application/json+oembed" href="resources/oembed-info.json" title="Org oEmbed Profile" /> +#+html_head: <meta name="flattr:id" content="8d9x0o"> +#+html_head: <link rel="apple-touch-icon" sizes="180x180" href="/resources/img/favicons/apple-touch-icon.png"> +#+html_head: <link rel="icon" type="image/png" sizes="32x32" href="/resources/img/favicons/favicon-32x32.png"> +#+html_head: <link rel="icon" type="image/png" sizes="16x16" href="/resources/img/favicons/favicon-16x16.png"> +#+html_head: <link rel="manifest" href="/resources/img/favicons/site.webmanifest"> +#+html_head: <link rel="mask-icon" href="/resources/img/favicons/safari-pinned-tab.svg" color="#77aa99"> +#+html_head: <link rel="shortcut icon" href="/resources/img/favicons/favicon.ico"> +#+html_head: <meta name="msapplication-TileColor" content="#77aa99"> +#+html_head: <meta name="msapplication-config" content="/resources/img/favicons/browserconfig.xml"> +#+html_head: <link rel="stylesheet" href="/resources/style/org.min.css" type="text/css" /> diff --git a/es/tools.org b/es/tools.org new file mode 100644 index 0000000..b60bb87 --- /dev/null +++ b/es/tools.org @@ -0,0 +1,411 @@ +#+title: Herramientas | Org mode +#+setupfile: setup.org +#+description: Org: un modo de Emacs para tomar notas, planificar y redactar documentos +#+include: "./resources/preamble.html" export html + +#+macro: link @@html:<a href="https://$1";>@@ +#+macro: httplink @@html:<a href="http://$1";>@@ +#+macro: gh {{{link(github.com/$1)}}} +#+macro: cb {{{link(codeberg.org/$1)}}} +#+macro: gl {{{link(gitlab.com/$1)}}} +#+macro: end-link @@html:</a>@@ + +#+macro: blog-icon @@html:<svg class="org-svg" xmlns="http://www.w3.org/2000/svg"; viewBox="0 0 24 24" width="24" height="24"><path d="M9.197 10a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5Zm-2.382 4a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5Zm-1.581 4a.75.75 0 0 0 0 1.5h6.5a.75.75 0 0 0 0-1.5h-6.5Z"></path><path d="M4.125 0h15.75a4.11 4.11 0 0 1 2.92 1.205A4.11 4.11 0 0 1 24 4.125c0 1.384-.476 2.794-1.128 4.16-.652 1.365-1.515 2.757-2.352 4.104l-.008.013c-.849 1.368-1.669 2.691-2.28 3.97-.614 1.283-.982 2.45-.982 3.503a2.625 2.625 0 1 0 4.083-2.183.75.75 0 1 1 .834-1.247A4.126 4.126 0 0 1 19.875 24H4.5a4.125 4.125 0 0 1-4.125-4.125c0-2.234 1.258-4.656 2.59-6.902.348-.586.702-1.162 1.05-1.728.8-1.304 1.567-2.553 2.144-3.738H3.39c-.823 0-1.886-.193-2.567-1.035A3.647 3.647 0 0 1 0 4.125 4.125 4.125 0 0 1 4.125 0ZM15.75 19.875c0-1.38.476-2.786 1.128-4.15.649-1.358 1.509-2.743 2.343-4.086l.017-.028c.849-1.367 1.669-2.692 2.28-3.972.614-1.285.982-2.457.982-3.514A2.615 2.615 0 0 0 19.875 1.5a2.625 2.625 0 0 0-2.625 2.625c0 .865.421 1.509 1.167 2.009A.75.75 0 0 1 18 7.507H7.812c-.65 1.483-1.624 3.069-2.577 4.619-.334.544-.666 1.083-.98 1.612-1.355 2.287-2.38 4.371-2.38 6.137A2.625 2.625 0 0 0 4.5 22.5h12.193a4.108 4.108 0 0 1-.943-2.625ZM1.5 4.125c-.01.511.163 1.008.487 1.403.254.313.74.479 1.402.479h12.86a3.648 3.648 0 0 1-.499-1.882 4.11 4.11 0 0 1 .943-2.625H4.125A2.625 2.625 0 0 0 1.5 4.125Z"></path></svg>@@ + +#+BEGIN_EXPORT html +<style> + #content { + max-width: 80rem; + } + .columns .outline-3 .org-svg, .columns .outline-3 img { + height: 6.5rem; + } + .columns .outline-3 h3 { + top: 4.5rem; + } + body { + padding-top: 2.5rem; + } +</style> +#+END_EXPORT + +* Android, iOS y web +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Emacs +{{{link(f-droid.org/packages/org.gnu.emacs/)}}} +https://www.gnu.org/software/emacs/images/emacs.png + +Versión móvil de Emacs (y Org mode). +(Android) +{{{end-link}}} +** Orgzly Revived +{{{link(www.orgzlyrevived.com)}}} +https://f-droid.org/repo/com.orgzlyrevived/en-US/icon_zDJg4zNlR43qvRI7a-yXV-DZt2Dr-ARnehGxsPc6cnc=.png + +Plantillas para tomar notas y manejar listas de tareas. +(Android) +{{{end-link}}} +** MobileOrg +{{{link(mobileorg.github.io/features/)}}} +https://mobileorg.github.io/img/logo.png + +Aplicación MobileOrg iPhone. +(iOS) +{{{end-link}}} +** Orgro +{{{link(orgro.org)}}} +https://orgro.org/assets/appicon.png + +Un visualizador y editor de ficheros Org para el móvil. +(Android, iOS) +{{{end-link}}} +** Organice +{{{link(organice.200ok.ch/)}}} +https://raw.githubusercontent.com/200ok-ch/organice/master/public/organice-small.png + +Una implementación de Org mode sin la dependencia de Emacs. +(Web) +{{{end-link}}} +** Org Note +{{{gh(Artawower/orgnote)}}} +https://github.com/Artawower/orgnote/raw/master/images/image.png + +Org Note, una aplicación para tomar notas. +(Web, Android) +{{{end-link}}} + +* Importar y exportar +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Pandoc +:PROPERTIES: +:HTML_CONTAINER_CLASS: starred +:END: +{{{link(pandoc.org)}}} +[[https://lh3.googleusercontent.com/-S8Fwe-PISrU/WExNwRXJHKI/AAAAAAAAAFo/tRbv1NAYBWoEBitmvDRFY_bc5xv07lnMACLcB/s1600/pandoc.png]] + +La navaja suiza de los convertidores de formato marcado. +Puede convertir documentos entre varios formatos fuentes, incluído Org. +{{{end-link}}} +** Org-ruby +{{{gh(wallyqs/org-ruby)}}} +[[https://upload.wikimedia.org/wikipedia/commons/7/73/Ruby_logo.svg]] + + +Herramientas Gem y CLI para convertir ficheros Org a HTML, Markdown o textile. Usado por GitHub +{{{end-link}}} + +** hop +{{{cb(bzg/hop)}}} +[[https://raw.githubusercontent.com/babashka/babashka/master/logo/babashka.svg]] + +Hop! Org Parser: una herramienta CLI para exportar ficheros Org a MD, HTML, Org, JSON, EDN, YAML e ICS. +{{{end-link}}} +* Publicación +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Hugo +{{{link(gohugo.io)}}} +[[https://upload.wikimedia.org/wikipedia/commons/a/af/Logo_of_Hugo_the_static_website_generator.svg]] + +Un generador de sitios estáticos escrito en Go, con soporte nativo para Org. +{{{end-link}}} +** Org-Jekyll +{{{link(orgmode.org/worg/org-tutorials/org-jekyll.html)}}} +[[https://cdn.worldvectorlogo.com/logos/jekyll.svg]] + +Una manera de combinar Org con un generador de sitios estáticos simple y orientado a blogs. +{{{end-link}}} +** Org2Blog +{{{gh(org2blog/org2blog)}}} +[[https://raw.githubusercontent.com/org2blog/org2blog/master/svg/Org2Blog_shorthand.svg]] + +Blog de Org mode a WordPress +{{{end-link}}} +** ORG-STATIC-BLOG +{{{gh(bastibe/org-static-blog)}}} +{{{blog-icon}}} + +Se centra en la simplicidad. Todos los ficheros son ficheros simples de org-mode en un directorio. +{{{end-link}}} +** emacs-ssg +{{{gl(sctlib/emacs-ssg)}}} +https://gitlab.com/sctlib/emacs-ssg/-/raw/main/assets/svg/logo.svg + +Paquete npm. Se utiliza Emacs en el background para generar las páginas del sitio web. +{{{end-link}}} + +** Org Clive +{{{gl(mbork_mbork_pl/org-clive)}}} +{{{blog-icon}}} + +Weblog está completamente controlado desde un /único/ fichero de Org mode. +{{{end-link}}} + +** one.el +{{{gh(tonyaldon/one.el)}}} +{{{blog-icon}}} + +Generador de sitios webs estáticos para personas programadoras de Emacs Lisp +{{{end-link}}} + +** lazyblorg +{{{gh(novoid/lazyblorg)}}} +{{{blog-icon}}} + +Bloguear con Org-mode para gente muy perezosa. +{{{end-link}}} + +** WriteFreely.el +{{{gh(dangom/writefreely.el)}}} +{{{blog-icon}}} + +Blogueo sin fricciones con Org-mode y https://writefreely.org/ +{{{end-link}}} + +** Orgy +{{{cb(bzg/orgy)}}} +{{{blog-icon}}} + +Un generador de blogs estáticos minimalista escrito en Clojure. +{{{end-link}}} +** Más... +{{{link(orgmode.org/worg/org-blog-wiki.html)}}} +[[https://static.thenounproject.com/png/608341-200.png]] + +Blogs y Wikis con Org +{{{end-link}}} + +* Utilidades +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Memacs +:PROPERTIES: +:HTML_CONTAINER_CLASS: starred +:END: +{{{gh(novoid/Memacs)}}} +[[https://static.thenounproject.com/png/870-200.png]] + +Un método para extraer y analizar metadatos de Org +{{{end-link}}} +** org-manage +{{{gh(dmgerman/org-manage)}}} +[[https://static.thenounproject.com/png/3266143-200.png]] + +Un módulo para ayudar a gestionar una gran cantidad de ficheros org +{{{end-link}}} +** orgFixLinks +{{{gh(cashTangoTangoCash/orgFixLinks)}}} +[[https://static.thenounproject.com/png/2805259-200.png]] + +Un script para intentar reparar enlaces a ficheros +{{{end-link}}} + +** Scrim +{{{httplink(yummymelon.com/scrim/)}}} +https://raw.githubusercontent.com/kickingvegas/scrim/main/scrim/Assets.xcassets/AppIcon.appiconset/scrim_resize_256x.png + +Scrim es una utilidad para reenviar peticiones de URL de Org protocol a Emacs en macOS. + +{{{end-link}}} + +** Captee +{{{httplink(yummymelon.com/captee/)}}} +https://raw.githubusercontent.com/kickingvegas/Captee/main/Captee/Assets.xcassets/AppIcon.appiconset/captee-256.png + +Captee es una aplicación que comparte un enlace (URL y título) en formato Org en un solo paso directamente desde el menú Compartir de macOS. + +{{{end-link}}} + +* Parseadores +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: + +# Some known parsers are omitted here: + +# https://github.com/rasendubi/uniorg has deviant syntax - we do not +# want to promote the Markdown flavour disaster. + +# https://github.com/tgbugs/laundry (no commits for over 1 year) +# https://github.com/fosskers/org-mode (old, and there is pandoc + org-mode-hs) +# https://github.com/eigenhombre/clj-org (unused by author; perspectives unclear) +# https://github.com/orgzly/org-java (no commits for over 1 year) + +** Pico Lisp +{{{link(bitbucket.org/joebo/pico-org/src)}}} +[[https://upload.wikimedia.org/wikipedia/commons/4/40/PicoLisp_Logo.svg]] + +/pico-org/ --- un pequeño parser de org-mode +{{{end-link}}} +** Common Lisp +{{{link(common-lisp.net/project/cl-org-mode/)}}} +[[https://lispcookbook.github.io/cl-cookbook/assets/cl-logo-blue.png]] + +/cl-org-mode/ crea un árbol de nodos de Org-mode. +Incluye un sistema (primitivo) para programación literaria. +{{{end-link}}} +** NodeJS +{{{link(/www.npmjs.com/package/org-mode-parser)}}} +[[https://seeklogo.com/images/N/nodejs-logo-FBE122E377-seeklogo.com.png]] + +/org-mode-parser/. +{{{end-link}}} +** Python +{{{gh(karlicoss/orgparse)}}} +[[https://cdn.iconscout.com/icon/free/png-256/python-14-569257.png]] + +/orgparse/ crea un árbol desde un archivo org. +{{{end-link}}} +** Perl +{{{link(metacpan.org/release/Org-Parser)}}} +[[https://upload.wikimedia.org/wikipedia/commons/f/f0/Cebolla_Chulita.png]] + +/Org::parser/. +{{{end-link}}} +** Rust +{{{gh(poiscript/orgize)}}} +[[https://upload.wikimedia.org/wikipedia/commons/d/d5/Rust_programming_language_black_logo.svg]] + +/Orgize/ parsea archivos org y puede convertirlos a HTML. +{{{end-link}}} +** JavaScript +{{{gh(orgapp/orgajs)}}} +[[https://upload.wikimedia.org/wikipedia/commons/9/99/Unofficial_JavaScript_logo_2.svg]] + +/Orga/ parsea archivos Org y los convierte en un AST. +{{{end-link}}} +** Dart +{{{link(pub.dev/packages/org_parser)}}} +https://upload.wikimedia.org/wikipedia/commons/a/a2/Dart_programming_language_logo_icon.svg + +/org\under{}parser/ --- Un parser de Org Mode parser para Dart +{{{end-link}}} +** Go +{{{gh(niklasfasching/go-org)}}} +https://upload.wikimedia.org/wikipedia/commons/a/a8/Go_Logo_Black.svg + +/go-org/ --- Parser que convierte ficheros Org en HTML con un renderizado bonito. También funciona como generador de sitios estáticos. +{{{end-link}}} +** Julia +{{{gh(tecosaur/Org.jl)}}} +https://upload.wikimedia.org/wikipedia/commons/6/69/Julia_prog_language.svg + +/Org.jl/ --- Una librería de Julia para trabajar con Org. +{{{end-link}}} + +** Clojure +{{{gh(200ok-ch/org-parser)}}} +https://upload.wikimedia.org/wikipedia/commons/5/5d/Clojure_logo.svg + +/org-parser/ --- se puede usar desde JavaScript, Java, Clojure y ClojureScript. +{{{end-link}}} + +** Clojure +{{{cb(bzg/organ)}}} +https://upload.wikimedia.org/wikipedia/commons/5/5d/Clojure_logo.svg + +/organ/ --- otro parser de Org para Clojure, que también se puede usar desde Babashka. +{{{end-link}}} + +** Tree-sitter +{{{gh(nvim-orgmode/tree-sitter-org)}}} +https://upload.wikimedia.org/wikipedia/commons/7/74/Tree-sitter-small.png + +/tree-sitter-org/ --- Gramática de Org para tree-sitter +{{{end-link}}} +** Ocaml +{{{gh(logseq/mldoc)}}} +https://upload.wikimedia.org/wikipedia/commons/f/ff/OCaml_Logo.svg + +/mldoc/ --- Parser de Org mode y Markdown. Utilizado por [[https://logseq.com/][Logseq]] +{{{end-link}}} + +** Haskell +{{{gh(lucasvreis/org-mode-hs)}}} +https://upload.wikimedia.org/wikipedia/commons/1/1c/Haskell-Logo.svg + +/org-mode-hs/ --- Parsear documentos de Org-mode con exportadores personalizables. +{{{end-link}}} + +** Typescript +{{{gh(Artawower/org-mode-ast)}}} +https://github.com/Artawower/org-mode-ast/raw/master/images/tree.png + +/org-mode-ast/ --- Árbol de sintaxis abstracta en TypeScript para Org-mode. +{{{end-link}}} + +* Exportadores +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Drupal converter +{{{link(www.drupal.org/project/orgmode)}}} +[[https://www.drupal.org/files/EL_blue_RGB%281%29.png]] + +Un módulo de Drupal capaz de importar ficheros individuales, como artículos, y transformarlos en nodos. +{{{end-link}}} +** Pandoc +{{{gh(kawabata/ox-pandoc)}}} +[[https://static.thenounproject.com/png/2710766-200.png]] + +/ox-pandoc/ integra Pandoc en la funcionalidad de exportación de Org. +{{{end-link}}} +** ox-hugo +:PROPERTIES: +:HTML_CONTAINER_CLASS: starred +:END: +{{{link(ox-hugo.scripter.co)}}} +[[https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg]] + +Un exportador a Markdown compatible con Hugo (Blackfriday), que permite un poco más de versatilidad. +{{{end-link}}} +** ox-⁎ +[[https://static.thenounproject.com/png/608341-200.png]] + +Hay muchos más exportadores de Org para Emacs. Solo échales un vistazo. +* Importadores +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Pandoc +{{{gh(tecosaur/org-pandoc-import)}}} +[[https://static.thenounproject.com/png/2404511-200.png]] + +/org-pandoc-import/ es una interfaz a Pandoc que hace trivial convertir otros formatos de marcado a Org. +{{{end-link}}} + +** VimWiki +{{{gh(fasheng/vimwiki2org)}}} +[[https://cdn.freebiesupply.com/logos/large/2x/vim-logo-png-transparent.png]] + +Una herramienta sencilla para convertir tu fichero vimwiki a Org +{{{end-link}}} +** Exchange calenders +{{{gh(kautsig/ews-orgmode)}}} +[[https://upload.wikimedia.org/wikipedia/commons/e/ea/Microsoft_Exchange_%282019-present%29.svg]] + +Un script para obtener tu calendario desde un servidor Exchange y verlo como agenda. +{{{end-link}}} +* IA +:PROPERTIES: +:HTML_CONTAINER_CLASS: columns +:END: +** Khoj +{{{link(khoj.dev)}}} +[[https://blog.khoj.dev/icons/logo_type.svg]] + +Un asistente personal IA para tu cerebro digital +{{{end-link}}} + +* +#+begin_center +#+attr_html: :class btn +[[https://orgmode.org/worg/org-tools/index.html][Más herramientas en la página de Worg]] +#+end_center + diff --git a/publish.sh b/publish.sh index c224474..4c624e2 100755 --- a/publish.sh +++ b/publish.sh @@ -45,6 +45,7 @@ This variable can be set when running publish.sh script: org-html-postamble t org-html-postamble-format `(("en" ,(get-postamble ".")) + ("es" ,(get-postamble "es")) ("zh-CN" ,(get-postamble "zh-CN")))) (dolist (org-file (directory-files-recursively "." "\\.org$")) diff --git a/resources/preamble.html b/resources/preamble.html index 8776057..3024a0a 100644 --- a/resources/preamble.html +++ b/resources/preamble.html @@ -6,6 +6,7 @@ <span id="translate"> [ <a title="English version" href="/index.html">en</a> + - <a title="Versión en español" href="/es/index.html">es</a> - <a title="Version française" href="/fr/index.html">fr</a> - <a title="Japanese version" href="/ja/index.html">ja</a> - <a title="简体中文版本" href="/zh-CN/index.html">简</a> diff --git a/zh-CN/resources/preamble.html b/zh-CN/resources/preamble.html index bf9cb6f..112060a 100644 --- a/zh-CN/resources/preamble.html +++ b/zh-CN/resources/preamble.html @@ -6,6 +6,7 @@ <span id="translate"> [ <a title="English version" href="/index.html">en</a> + - <a title="Versión en español" href="/es/index.html">es</a> - <a title="Version française" href="/fr/index.html">fr</a> - <a title="Japanese version" href="/ja/index.html">ja</a> - <a title="简体中文版本" href="/zh-CN/index.html">简</a> -- 2.50.1 (Apple Git-155)
Ihor Radchenko <[email protected]> writes: > "Andros Fenollosa" <[email protected]> writes: > >> Thanks for the detailed review. Please find attached an updated patch >> that addresses all the points you raised: >> >> 1. Added the "Project heartbeat" section to es/index.org. While at it, I >> also added the "Mobile/Web" highlight and the source-code mirror >> badge, and fixed the author banner. >> 2. Synced es/tools.org with tools.org: the "Android, iOS and web" >> section, Emacs, hop, Orgy, Scrim, Captee and the second Clojure >> parser. I dropped the Logseq entry to match the English page. >> 3. Added the ORG-NEWS #+INCLUDE and the kbd macro to es/Changes.org. >> 4. Added the missing #+description lines. >> 5. Fixed the broken manual and guide links in es/quickstart.org. >> 6. Replaced the leftover full-width colon (and other CJK punctuation and >> text) with proper Spanish. > > Thanks! > >> I also added the "es" language link to the root and zh-CN preambles, and >> structured the patch like the zh-CN translation: only the .org sources, >> org-demo.html and the resources/ links are tracked, while the generated >> .html pages are ignored via es/.gitignore. > > What is the motivation of adding .gitignore? We do not have it for the > rest of the orgweb repo. > >> The Spanish translation is by Laura (in Cc); I helped with the technical >> side. > > May I know if Laura had a chance to complete the FSF copyright > assignment? As I mentioned earlier, our main website requires the > assignment. Instructions in > https://orgmode.org/worg/org-contribute.html#copyright > >> Subject: [PATCH] Add Spanish (es) translation of the website >> >> Translate the orgmode.org pages into Spanish under es/, mirroring the >> layout of the existing zh-CN translation (only the .org sources, >> org-demo.html and the resources/ links are tracked; generated .html >> pages are ignored via es/.gitignore). >> >> This incorporates the mailing list review feedback: >> >> * es/index.org: Add the "Project heartbeat" section, the "Mobile/Web" >> highlight and the source-code mirror badge; fix the author banner. >> * es/tools.org: Sync with tools.org (Android/iOS/web section, Emacs, >> hop, Orgy, Scrim, Captee and the second Clojure parser); drop the >> Logseq entry, matching the English page. >> * es/Changes.org: Add the ORG-NEWS #+INCLUDE and the kbd macro. >> * es/features.org, es/quickstart.org, es/manuals.org: Add the missing >> #+description lines. >> * es/quickstart.org: Fix the broken manual and guide links. >> * es/org-demo.html, es/setup.org, es/manuals.org, es/index.org: Replace >> leftover CJK text and punctuation with Spanish. >> * resources/preamble.html, zh-CN/resources/preamble.html: Add the es >> language link. > > These are the changes after the latest iteration of the review. > The commit message should instead describe overall changes made in the > patch. > >> +++ b/es/index.org >> @@ -0,0 +1,301 @@ >> +#+title: Org mode para GNU Emacs >> +#+setupfile: setup.org >> +#+language: es > > Since you specify language, we will also need a small update in > publish.sh for org-html-postamble-format. I could do it myself, but > since we need to adjust the commit message anyway, leaving this comment > here. -- Andros Fenollosa https://andros.dev/
![https://elpa.gnu.org/packages/org.svg"](https://elpa.gnu.org/packages/org.svg"){kind=link}
![https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg"](https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg"){kind=link}
![https://upload.wikimedia.org/wikipedia/commons/5/5d/Konigsberg_bridges.png]]~](https://upload.wikimedia.org/wikipedia/commons/5/5d/Konigsberg_bridges.png]]~){kind=link}
![https://orgmode.org/resources/img/social-card.png"](https://orgmode.org/resources/img/social-card.png"){kind=link}
