diff options
author | Gareth Rees <gareth@mysociety.org> | 2015-01-14 15:46:14 +0000 |
---|---|---|
committer | Gareth Rees <gareth@mysociety.org> | 2015-04-07 16:25:04 +0100 |
commit | 828f01062a19705205b453d8cf5ce43fd39a9ac2 (patch) | |
tree | 54e72c92aaeaade5ed355f91a17434d8475cdbb3 | |
parent | db0320400dfe5729f95d56a7ee8296c3c66a9eca (diff) |
Add Spanish docs/installing/next_steps
-rw-r--r-- | docs/installing/next_steps.md | 38 | ||||
-rw-r--r-- | es/docs/installing/next_steps.md | 122 |
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/). |