aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGareth Rees <gareth@mysociety.org>2015-01-14 15:44:55 +0000
committerGareth Rees <gareth@mysociety.org>2015-04-07 16:23:13 +0100
commit70060d92b665b8ff7c1a2a4b03e742ef86a94d1c (patch)
treec3e359699ee048045fdb4232dd9fe0d73e477a5b
parent576688aefc86a2e7e39d69e48d2c4a48a8606678 (diff)
Add Spanish docs/installing/index
-rw-r--r--docs/installing/index.md24
-rw-r--r--es/docs/installing/index.md65
2 files changed, 77 insertions, 12 deletions
diff --git a/docs/installing/index.md b/docs/installing/index.md
index c04aaa3ca..269407506 100644
--- a/docs/installing/index.md
+++ b/docs/installing/index.md
@@ -17,8 +17,8 @@ title: Installing
## Before you start
This is important: you need to decide if you are installing Alaveteli for
-<a href="{{ site.baseurl }}docs/glossary/#development" class="glossary__link">development</a> or
-<a href="{{ site.baseurl }}docs/glossary/#production" class="glossary__link">production</a>.
+<a href="{{ page.baseurl }}/docs/glossary/#development" class="glossary__link">development</a> or
+<a href="{{ page.baseurl }}/docs/glossary/#production" class="glossary__link">production</a>.
A **development** site is one where you're going to change, customise, and
perhaps experiment while you get it up and running. You should always do this
@@ -30,10 +30,10 @@ A **production** site is different: you want your production site to run as
efficiently as possible, so things like caching are swiched on, and debug
messages switched off. It's important to be able to deploy changes to a
production site quickly and efficiently, so we recommend you consider using a
-[deployment mechanism]({{ site.baseurl }}docs/installing/deploy/) too.
+[deployment mechanism]({{ page.baseurl }}/docs/installing/deploy/) too.
Ideally, you should also have a
-<a href="{{ site.baseurl }}docs/glossary/#staging" class="glossary__link">staging site</a>,
+<a href="{{ page.baseurl }}/docs/glossary/#staging" class="glossary__link">staging site</a>,
which is used solely to test new code in an identical environment to your
production site before it goes live.
@@ -44,23 +44,23 @@ production server.
## Deployment
If you're running a production server, we **strongly recommend** you
-use the Capistrano [deployment mechanism]({{ site.baseurl }}docs/installing/deploy/)
+use the Capistrano [deployment mechanism]({{ page.baseurl }}/docs/installing/deploy/)
that's included with Alaveteli. Set this up and you never have to edit files on
those servers, because Capistrano takes care of that for you.
## Installing the core code
-* [Install into a Vagrant virtual development environment]({{ site.baseurl }}docs/installing/vagrant/) -- a good choice for development, and playing around with the site.
-* [Install on Amazon EC2]({{ site.baseurl }}docs/installing/ami/) using our AMI
-* [Use the installation script]({{ site.baseurl }}docs/installing/script/) which does the full installation on your own server
-* [Manual installation]({{ site.baseurl }}docs/installing/manual_install/) -- step-by-step instructions
+* [Install into a Vagrant virtual development environment]({{ page.baseurl }}/docs/installing/vagrant/) -- a good choice for development, and playing around with the site.
+* [Install on Amazon EC2]({{ page.baseurl }}/docs/installing/ami/) using our AMI
+* [Use the installation script]({{ page.baseurl }}/docs/installing/script/) which does the full installation on your own server
+* [Manual installation]({{ page.baseurl }}/docs/installing/manual_install/) -- step-by-step instructions
If you're setting up a development server on MacOS X, we've also got
-[MacOS installation instructions]({{ site.baseurl }}docs/installing/macos/).
+[MacOS installation instructions]({{ page.baseurl }}/docs/installing/macos/).
## Other installation information
Alaveteli needs to be able to send and receive email. If you're installing manually, you need to [setup your
-MTA (Mail Transfer Agent) appropriately]({{ site.baseurl }}docs/installing/email/). The other install methods will do this for you.
+MTA (Mail Transfer Agent) appropriately]({{ page.baseurl }}/docs/installing/email/). The other install methods will do this for you.
-* [Installing the MTA]({{ site.baseurl }}docs/installing/email/)
+* [Installing the MTA]({{ page.baseurl }}/docs/installing/email/)
diff --git a/es/docs/installing/index.md b/es/docs/installing/index.md
new file mode 100644
index 000000000..29de03dad
--- /dev/null
+++ b/es/docs/installing/index.md
@@ -0,0 +1,65 @@
+---
+layout: es/page
+title: Instalación
+---
+
+# Instalación de Alaveteli
+
+<p class="lead">
+ Existen diversas formas de instalar Alaveteli.
+ Hemos elaborado una Amazon Machine Image (AMI) para que pueda desplegar rápidamente
+ en EC2 de Amazon (práctico si solamente desea evaluarlo, por ejemplo).
+ Si prefiere utilizar su propio servidor, existe un script de instalación que
+ efectúa la mayor parte del trabajo, o también puede seguir las instrucciones de
+ instalación manual.
+</p>
+
+## Antes de empezar
+
+Importante: necesita decidir si está instalando Alaveteli para su
+<a href="{{ page.baseurl }}/docs/glossary/#development" class="glossary__link">desarrollo</a> o su
+<a href="{{ page.baseurl }}/docs/glossary/#production" class="glossary__link">producción</a>.
+
+Un servidor de **desarrollo** en aquel donde modificará, personalizará y tal vez
+experimentará mientras lo pone en funcionamiento. Siempre debería hacer esto en primer
+lugar. En este entorno podrá ver mensajes de depuración y no necesitará preocuparse
+demasiado sobre la eficiencia y el rendimiento del sitio (pues en realidad no
+recibe gran cantidad de tráfico).
+
+Un servidor de **producción** es diferente: le interesa que el servidor de producción funcione
+de la forma más eficiente posible, así que opciones tales como la memoria caché se activan
+y otras como los mensajes de depuración se desactivan. Es importante que pueda implementar cambios
+rápida y eficientemente en un servidor de producción, por lo que recomendamos que considere también
+ el uso de un [mecanismo de despliegue]({{ page.baseurl }}/docs/installing/deploy/).
+
+Lo ideal sería que también tuviera un
+<a href="{{ page.baseurl }}/docs/glossary/#staging" class="glossary__link">servidor de pruebas</a>,
+utilizado exclusivamente para probar el código nuevo en un entorno idéntico a su servidor
+de producción antes de publicarlo.
+
+Si tiene dudas, probablemente deba utilizar un servidor de desarrollo. Póngalo en marcha, juegue
+con él, personalícelo y, más adelante, puede instalarlo como un servidor de producción.
+
+## Despliegue
+
+Si está utilizando un servidor de producción, le **recomendamos encarecidamente** el
+uso del [mecanismo de despliegue]({{ page.baseurl }}/docs/installing/deploy/) Capistrano
+incluido en Alaveteli. Configúrelo y nunca tendrá que editar archivos en estos servidores,
+pues Capistrano se encargará de ello en su lugar.
+
+## Instalación del código principal
+
+* [Instalación en un entorno de desarrollo virtual de Vagrant]({{ page.baseurl }}/docs/installing/vagrant/): una buena elección para desarrollo y para poder jugar con el sitio.
+* [Instalación con EC2 de Amazon]({{ page.baseurl }}/docs/installing/ami/) utilizando nuesta AMI.
+* [Instalación utilizando el script]({{ page.baseurl }}/docs/installing/script/) que efectúa la instalación completa en su propio servidor.
+* [Instalación manual]({{ page.baseurl }}/docs/installing/manual_install/): instrucciones paso a paso.
+
+Si está configurando un servidor de desarrollo en MacOS X, también disponemos de
+[instrucciones de instalación para MacOS]({{ page.baseurl }}/docs/installing/macos/).
+
+## Otros datos sobre la instalación
+
+Alaveteli necesita poder enviar y recibir correo. Si efectúa la instalación manual, necesitará [configurar su
+MTA (servidor de correo) en consecuencia]({{ page.baseurl }}/docs/installing/email/). Los otros métodos de instalación lo harán automáticamente.
+
+* [Instalación del MTA]({{ page.baseurl }}/docs/installing/email/).