aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGareth Rees <gareth@mysociety.org>2015-01-14 15:46:14 +0000
committerGareth Rees <gareth@mysociety.org>2015-04-07 16:25:04 +0100
commit828f01062a19705205b453d8cf5ce43fd39a9ac2 (patch)
tree54e72c92aaeaade5ed355f91a17434d8475cdbb3
parentdb0320400dfe5729f95d56a7ee8296c3c66a9eca (diff)
Add Spanish docs/installing/next_steps
-rw-r--r--docs/installing/next_steps.md38
-rw-r--r--es/docs/installing/next_steps.md122
2 files changed, 140 insertions, 20 deletions
diff --git a/docs/installing/next_steps.md b/docs/installing/next_steps.md
index 2b7acbd45..5ebd395aa 100644
--- a/docs/installing/next_steps.md
+++ b/docs/installing/next_steps.md
@@ -20,11 +20,11 @@ title: Next Steps
## Create a superuser admin account
Alaveteli ships with an
-<a href="{{site.baseurl}}docs/glossary/#emergency" class="glossary__link">emergency user</a>
+<a href="{{ page.baseurl }}/docs/glossary/#emergency" class="glossary__link">emergency user</a>
that has access to the admin. So when you've just created a new site, you
should sign up to create your own account, then log into admin as the emergency
user to promote your new account to be an administrator with
-<a href="{{ site.baseurl }}docs/glossary/#super" class="glossary__link">super</a>
+<a href="{{ page.baseurl }}/docs/glossary/#super" class="glossary__link">super</a>
privilege.
As soon as that's done, disable the emergency user, because you don't need to
@@ -42,8 +42,8 @@ First, in the browser:
* Go to `/profile/sign_in` and create a user by signing up.
* Check your email and confirm your account.
* Go to `/admin?emergency=1`, log in with the username and password you specified in
- [`ADMIN_USERNAME`]({{site.baseurl}}docs/customising/config/#admin_username)
- and [`ADMIN_PASSWORD`]({{site.baseurl}}docs/customising/config/#admin_password).
+ [`ADMIN_USERNAME`]({{ page.baseurl }}/docs/customising/config/#admin_username)
+ and [`ADMIN_PASSWORD`]({{ page.baseurl }}/docs/customising/config/#admin_password).
You can find these settings in `config/general.yml`.
* You're now on the Alaveteli admin page.
* Click on **Users** (in the navigation menu across the top of the page), and
@@ -73,13 +73,13 @@ emergency user access to the admin. On the command line shell, edit
* It's important that you change the emergency user's password (and, ideally,
the username too) from the values Alavateli ships with, because they are
public and hence insecure. In `general.yml`, change
- [`ADMIN_PASSWORD`]({{site.baseurl}}docs/customising/config/#admin_password)
- (and maybe [`ADMIN_USERNAME`]({{site.baseurl}}docs/customising/config/#admin_username)
+ [`ADMIN_PASSWORD`]({{ page.baseurl }}/docs/customising/config/#admin_password)
+ (and maybe [`ADMIN_USERNAME`]({{ page.baseurl }}/docs/customising/config/#admin_username)
too) to new, unique values.
* Additionally, you can totally disable the emergency user. Under normal
operation you don't need it, because from now on you'll be using the admin
user you've just created.
- Set [`DISABLE_EMERGENCY_USER`]({{site.baseurl}}docs/customising/config/#disable_emergency_user)
+ Set [`DISABLE_EMERGENCY_USER`]({{ page.baseurl }}/docs/customising/config/#disable_emergency_user)
to `true`.
* To apply these changes restart the service as a user with root privileges:
`sudo service alaveteli restart`
@@ -119,8 +119,8 @@ follow the steps described in the previous section.
* You should receive the request email -- try replying to it. Your response
email should appear in Alaveteli. Not working? Take a look at our
- [troubleshooting tips]({{ site.baseurl}}docs/installing/manual_install/#troubleshooting).
- If that doesn't sort it out, [get in touch]({{ site.baseurl}}community/) on
+ [troubleshooting tips]({{ page.baseurl }}/docs/installing/manual_install/#troubleshooting).
+ If that doesn't sort it out, [get in touch]({{ page.baseurl }}/community/) on
the [developer mailing list](https://groups.google.com/forum/#!forum/alaveteli-dev) or [IRC](http://www.irc.mysociety.org/) for help.
## Import Public Authorities
@@ -128,7 +128,7 @@ follow the steps described in the previous section.
Alaveteli can import a list of public authorities and their contact email addresses from a CSV file.
Follow the instructions for
-[uploading public authority data]({{ site.baseurl }}docs/running/admin_manual/#creating-changing-and-uploading-public-authority-data).
+[uploading public authority data]({{ page.baseurl }}/docs/running/admin_manual/#creating-changing-and-uploading-public-authority-data).
## Set the amount of time authorities will be given to respond to requests
@@ -137,13 +137,13 @@ have a certain number of days in order to respond to requests. Alaveteli
helps requesters by reminding them when their request is overdue for a
response according to the law. You can set the number of days an
authority is given to respond to a request in the
-[`REPLY_LATE_AFTER_DAYS`]({{site.baseurl}}docs/customising/config/#reply_late_after_days),
-[`REPLY_VERY_LATE_AFTER_DAYS`]({{site.baseurl}}docs/customising/config/#reply_very_late_after_days)
+[`REPLY_LATE_AFTER_DAYS`]({{ page.baseurl }}/docs/customising/config/#reply_late_after_days),
+[`REPLY_VERY_LATE_AFTER_DAYS`]({{ page.baseurl }}/docs/customising/config/#reply_very_late_after_days)
and
-[`SPECIAL_REPLY_VERY_LATE_AFTER_DAYS`]({{site.baseurl}}docs/customising/config/#special_reply_very_late_after_days)
+[`SPECIAL_REPLY_VERY_LATE_AFTER_DAYS`]({{ page.baseurl }}/docs/customising/config/#special_reply_very_late_after_days)
options in `config/general.yml`. Most laws specify that the days are
either working days, or calendar days. You can set this using the
-[`WORKING_OR_CALENDAR_DAYS`]({{site.baseurl}}docs/customising/config/#working_or_calendar_days)
+[`WORKING_OR_CALENDAR_DAYS`]({{ page.baseurl }}/docs/customising/config/#working_or_calendar_days)
option in `config/general.yml`.
## Add some public holidays
@@ -153,17 +153,17 @@ Interface introduced in Alaveteli version 0.21
</div>
Alaveteli calculates the due dates of requests taking account of the
-<a href="{{ site.baseurl }}docs/glossary/#holiday" class="glossary__link">public holidays</a>
+<a href="{{ page.baseurl }}/docs/glossary/#holiday" class="glossary__link">public holidays</a>
you enter into the admin interface.
If you have set the
-[`WORKING_OR_CALENDAR_DAYS`]({{site.baseurl}}docs/customising/config/#working_or_calendar_days)
+[`WORKING_OR_CALENDAR_DAYS`]({{ page.baseurl }}/docs/customising/config/#working_or_calendar_days)
setting for Alaveteli to `working`, the date when a response to a
request is officially overdue will be calculated in days that are not
weekends or public holidays.
If you have set
-[`WORKING_OR_CALENDAR_DAYS`]({{site.baseurl}}docs/customising/config/#working_or_calendar_days)
+[`WORKING_OR_CALENDAR_DAYS`]({{ page.baseurl }}/docs/customising/config/#working_or_calendar_days)
to `calendar`, the date will be calculated in calendar days, but if the
due date falls on a public holiday or weekend day, then the due date is
considered to be the next week day that isn't a holiday.
@@ -176,6 +176,4 @@ once using the **Create holidays from suggestions or iCalendar feed** button.
## Start thinking about customising Alaveteli
-Check out [our guide]({{ site.baseurl}}docs/customising/).
-
-
+Check out [our guide]({{ page.baseurl }}/docs/customising/).
diff --git a/es/docs/installing/next_steps.md b/es/docs/installing/next_steps.md
new file mode 100644
index 000000000..d20c06675
--- /dev/null
+++ b/es/docs/installing/next_steps.md
@@ -0,0 +1,122 @@
+---
+layout: es/page
+title: Siguientes pasos
+---
+# Siguientes pasos
+
+<p class="lead">
+ Bien, ha instalado una copia de Alaveteli y puede visualizar el sitio en un navegador. ¿Qué debe hacer ahora?
+</p>
+
+## Cree una cuenta de administrador superusuario
+
+Alaveteli incluye un
+<a href="{{ page.baseurl }}/docs/glossary/#emergency" class="glossary__link">usuario de emergencia</a>
+que tiene acceso a la interfaz de administración. Así, cuando acabe de crear un sitio, deberá
+registrarse para crear su propia cuenta y después iniciar sesión en la interfaz de administración
+con el usuario de emergencia para ascender su nueva cuenta a administrador con permisos de *superusuario*.
+
+Una vez hecho esto, desactive el usuario de emergencia, pues no necesitará utilizarlo más: lo habrá
+reemplazado con su nueva cuenta de administrador.
+
+Alaveteli incluye datos de muestra con un usuario administrador llamado «Joe
+Admin». Si los datos de muestra se han cargado en la base de datos (depende del tipo
+de instalación elegido), deberá revocar también los permisos de administrador de Joe, pues
+utilizará su propia cuenta de administrador en su lugar.
+
+### Paso a paso:
+
+En primer lugar, en el navegador:
+
+* Acceda a `/profile/sign_in` y cree un usuario siguiendo el proceso de registro.
+* Consulte su correo y confirme su cuenta.
+* Acceda a `/admin?emergency=1`, inicie sesión con el código de usuario y la contraseña
+ que ha especificado en [`ADMIN_USERNAME`]({{ page.baseurl }}/docs/customising/config/#admin_username)
+ y [`ADMIN_PASSWORD`]({{ page.baseurl }}/docs/customising/config/#admin_password).
+ Puede consultar estos ajustes en `config/general.yml`.
+* Ahora se encontrará en la página de adminsitración de Alaveteli.
+* Haga clic en **Users** (en el menú de navegación superior de la página) y eliga
+ su nombre en el listado de usuarios. En *esa* página, haga clic en **Edit**.
+* Modifique su *Admin level* a «super» y haga clic en **Save**.
+* A partir de ahora, al iniciar sesión en su sitio basado en Alavateli, tendrá acceso
+ a la interfaz de administración (en `/admin`). Es más, verá enlaces a páginas administrativas
+ externas al sitio principal (que no son visibles para usuarios comunes).
+
+Si su instalación ha cargado los datos de muestra, habrá un usuario de prueba en su base
+de datos llamado «Joe Admin» también con permisos de administrador. Deberá eliminar estos
+permisos para que no exista riesgo de que se utilice para acceder a la administración de su
+sitio. Puede hacer esto mientras tiene la sesión iniciada como usuario de emergencia o más tarde,
+iniciando su propia sesión:
+
+* Acceda a `/admin/users` o haga clic en **Users** en el menú de navegación de la
+ página de administración.
+* Busque «Joe Admin» en el listado de usuarios y haga clic en el nombre para ver los
+ detalles del usuario. En *esa* página, haga clic en **Edit**.
+* Modifique su *Admin level* de «super» a «none» y haga clic en **Save**.
+* Joe Admin ya no tendrá permisos de administrador.
+
+Ahora que su cuenta corresponde a un superusuario administrador, no necesita permitir el
+acceso del usuario de emergencia a la interfaz de administración. En la línea de comando, edite
+`/var/www/alaveteli/alaveteli/config/general.yml`:
+
+* Es importante que modifique la contraseña del usuario de emergencia (e, idealmente,
+ también el código de usuario) que se incluye en Alavateli, pues es públicos y
+ consecuentemente no seguro. En `general.yml`, cambie
+ [`ADMIN_PASSWORD`]({{ page.baseurl }}/docs/customising/config/#admin_password)
+ (y tal vez [`ADMIN_USERNAME`]({{ page.baseurl }}/docs/customising/config/#admin_username)
+ también) por un valor nuevo exclusivo.
+* También puede desactivar totalmente el usuario de emergencia. En condiciones
+ normales no lo necesitará, pues a partir de ahora utilizará el usuario administrador que
+ acaba de crear.
+ Asigne a [`DISABLE_EMERGENCY_USER`]({{ page.baseurl }}/docs/customising/config/#disable_emergency_user)
+ el valor `true`.
+* Para aplicar estos cambios, reinicie el servicio como usuario con permisos root:
+ `sudo service alaveteli restart`
+
+Puede utilizar el mismo proceso (con su sesión de administrador iniciada) para añadir o eliminar
+permisos de superusuario administrador de cualquier usuario que añada en su sitio.
+Si elimina accidentalmente los permisos de administrador de todas las cuentas (¡pero intente que
+esto no ocurrra!), puede activar el usuario de emergencia editando el archivo `general.yml`
+y reiniciando Alaveteli.
+
+## Cargue los datos de muestra
+
+Si desea tener algunos datos de muestra con los que probar, puede intentar cargar los elementos comunes que utiliza
+la suite de pruebas en su base de datos de desarrollo. Como usuario `alaveteli`, ejecute:
+
+ script/load-sample-data
+
+Si los datos de muestra ya se han cargado en la base de datos, este comando no hará nada, sino que
+<abbr title='PG::Error: ERROR: permission denied: "RI_ConstraintTrigger_XXXXXX" is a system trigger'>generará un error</abbr>.
+
+Si ha añadido los datos de muestra, actualice después el índice de búsqueda de Xapian:
+
+ script/update-xapian-index
+
+Recuerde que los datos de muestra incluyen un usuario con permisos de administrador en su sitio.
+Debería revocar estos permisos para que no pueda utilizarse en el acceso a su sitio: siga
+los pasos descritos en la sección anterior.
+
+## Pruebe el proceso de solicitud
+
+* Cree una nueva autoridad pública en la interfaz de administración, dele un nombre tal como
+ «Autoridad de prueba». Defina el correo de solicitud con una dirección que le pertenezca.
+
+* Desde la interfaz principal del sitio, efectúe una solicitud a la nueva autoridad.
+
+* Debería recibir el correo de la solicitud, intente responder a él. Su correo de respuesta
+ debería aparecer en Alaveteli. ¿No funciona? Consulte nuestros
+ [consejos para la solución de problemas]({{ page.baseurl }}/docs/installing/manual_install/#solucin-de-problemas).
+ Si no es suficiente, [póngase en contacto]({{ page.baseurl }}/community/) mediante
+ la [lista de correo de desarrollo](https://groups.google.com/forum/#!forum/alaveteli-dev) o por [IRC](http://www.irc.mysociety.org/)
+ para obtener ayuda.
+
+## Importe las autoridades públicas
+
+Alaveteli puede importar un listado de autoridades públicas y sus direcciones de correo de contacto desde un archivo CSV.
+
+Encontrará el cargador en la pestaña «Authorities» de la sección de administración o accediendo directamente a `/admin/body/import_csv`.
+
+## Empiece a pensar en la personalización de Alaveteli
+
+Consulte [nuestro manual]({{ page.baseurl }}/docs/customising/).