Esta página se está traducido el 2014-12-08.
Es posible que la versión inglés se actualizaba desde luego.
Glosario
Glosario de términos de Alaveteli, la plataforma de información pública de mySociety.
Definiciones
- Alaveteli
- imparcial respecto al solicitante
- autoridad
- agujero negro
- mensaje rebotado
- Capistrano
- norma de censura
- servidor de desarrollo
- usuario de emergencia
- información pública
- git
- sala de espera
- MTA
- archivos .po
- servidor de producción
- publicar
- recaptcha
- editar
- expresión regular
- solicitud
- actualización
- respuesta
- Ruby on Rails
- Sass
- servidor de pruebas
- estado
- tema
- Alaveteli
-
Alaveteli es el nombre de la plataforma de software de código abierto creada
por mySociety para enviar,
gestionar y archivar solicitudes de información pública.
Se construyó a partir del exitoso proyecto de información pública de Reino Unido WhatDoTheyKnow. Utilizamos el nombre Alaveteli para distinguir el software que sustenta la plataforma respecto de cualquier sitio web específico que la utilice.
Más información:
- El sitio web de Alaveteli se halla en www.alaveteli.org.
- El nombre «Alaveteli» proviene de Alaveteli, Finlandia, donde una vez trabajó un antiguo defensor de la información pública.
- imparcial respecto al solicitante
-
La ley de información pública normalmente considera que
las respuestas ofrecidas por las
autoridades son imparciales respecto al solicitante. Esto significa
que la respuesta no debería cambiar en nada en relación a quién haya solicitado
la información. Como consecuencia, la respuesta
puede publicarse, ya que en teoría todo el mundo
podría preguntar lo mismo y, por ley, debería recibir la misma información.
A pesar de ello, sigue siendo bastante común a nivel mundial que las autoridades respondan a las solicitudes de información pública de forma privada, en lugar de publicar ellas mismas sus respuestas. Por tanto, una de las funciones de Alaveteli consiste en actuar como repositorio público de las respuestas recibidas. Esto también sirve para reducir solicitudes duplicadas, pues la respuesta es pública y evita que la pregunta se tenga que repetir de nuevo.
- autoridad
-
Llamamos autoridad a cualquier organismo, organización,
departamento o compañía a los que los usuarios pueden enviar solicitudes.
Más información:
- Un administrador puede añadir, editar o eliminar autoridades en el apartado de administración.
- Las autoridades son habitualmente, aunque no siempre, organismos públicos obligados a responder por la ley local de información pública. A veces se establece un sitio basado en Alaveteli en una jurisdicción que aún no cuenta con una ley de información pública. En el Reino Unido hemos añadido a nuestro sitio WhaDoTheyKnow algunas autoridades que no están sujetas a la ley de información pública, pero que se han sometido a ella de forma voluntaria o creemos que deberían tenerse en cuenta en este ámbito.
- agujero negro
-
Un agujero negro es una dirección de correo electrónico que acepta y destruye
todos los mensajes de correo que recibe. Alaveteli lo utiliza para los mensajes de correo que no
admiten respuestas, normalmente generados de forma automática por sistemas de correo.
</p>
Más información:
-
Utilice la opción de configuración
BLACKHOLE_PREFIX
para especificar el aspecto de esta dirección de correo. -
Por otra parte, revise
CONTACT_EMAIL
para especificar la dirección que recibirá mensajes de correo de los usuarios (por ejemplo, solicitudes de soporte).
-
Utilice la opción de configuración
- mensaje rebotado
-
Un mensaje rebotado es generado automáticamente por un sistema de correo para informar
al remitente de un mensaje sobre problemas ocurridos en la entrega de dicho mensaje.
</p>
Más información:
- Cómo gestiona el correo Alaveteli.
- Página de wikipedia sobre mensajes rebotados.
- Capistrano
-
Capistrano es una herramienta de implementación y automatización en un servidor remoto escrita en Ruby,
utilizada por el mecanismo opcional de implementación de Alaveteli.
Más información:
- Cómo implementar Alaveteli (y por qué es una buena idea).
- El sitio web de Capistrano dispone de documentación minuciosa sobre esta herramienta.
- norma de censura
-
Los administradores de Alaveteli pueden definir normas de censura para identificar
qué partes de las respuestas deberían ser
editadas.
</p>
Más información:
- Consulte el manual de administrador para obtener más información sobre las normas de censura.
- Las normas de censura pueden simplemente editar texto que concuerde exactamente con una frase u oración en particular, así como utilizar expresiones regulares.
- servidor de desarrollo
-
Un servidor de desarrollo soporta la ejecución de su sitio basado en Alaveteli
para que pueda personalizarlo, experimentar
con distintas opciones y ponerlo a prueba hasta conseguir que desempeñe las funciones deseadas.
Es diferente de un
servidor de producción, que es
visitado por usuarios auténticos y funciona con datos reales, así como de un
servidor de pruebas,
utilizado para probar el código antes de publicarlo.
En el servidor de desarrollo debe asignar a
STAGING_SITE
el valor1
. - usuario de emergencia
-
Alaveteli incluye la configuración de un usuario de emergencia.
Esta configuración ofrece un código de usuario y una contraseña para acceder a la página de administración, incluso
si el usuario no aparece en la base de datos.
Cuando el sistema ha sido arrancado (es decir, cuando se ha utilizado el usuario de emergencia para proporcionar a una cuenta de usuario permisos totales de administrador), el usuario de emergencia debe deshabilitarse.
Más información:
-
El código de usuario y la contraseña están definidos en los ajustes de configuración
ADMIN_USERNAME
yADMIN_PASSWORD
. - Si desea consultar un ejemplo de usuario de emergencia, acceda a la creación de una cuenta de administrador.
-
Para desactivar el usuario de emergencia, configure la opción
DISABLE_EMERGENCY_USER: true
.
-
El código de usuario y la contraseña están definidos en los ajustes de configuración
- Información pública
-
Las leyes de información pública permiten al público acceder a datos
almacenados por los gobiernos nacionales. Establecen un proceso legal para el derecho a saber,
que permite solicitar información guardada por los gobiernos y recibirla de forma
gratuita por un mínimo coste, salvo excepciones estándar.
[Wikipedia]Más información:
- Resumen de Wikipedia sobre las leyes de información pública por países.
- git (también llamado «github» o «repositorio git»)
-
Utilizamos un popular sistema de control de código fuente llamado git. Este sistema
nos ayuda a monitorizar los cambios realizados en el código y también facilita a otras personas
la duplicación de nuestro software y la colaboración en su elaboración.
El sitio web github.com es un lugar público central donde está disponible nuestro software. Debido a que se trata de código abierto, puede revisarlo (Alaveteli está en su mayoría escrito en el lenguaje de programación Ruby) e informar de errores, así como sugerir funcionalidades y otras numerosas características prácticas.
El conjunto completo de archivos que forman la plataforma Alaveteli se denomina repositorio git. Al instalar Alaveteli, está clonando nuestro repositorio en su propio equipo.
Más información:
- Consulte las instrucciones de instalación que clonarán el repositorio de Alaveteli.
- Todo sobre git en el sitio web oficial.
- Consulte los proyectos de mySociety en github.
- sala de espera
-
La sala de espera es un lugar conceptual donde se almacenan los mensajes
que no se han podido entregar y necesitan ser revisados por un administrador.
Más información:
- Consulte la información incluida en el manual de administrador sobre cómo gestionar los mensajes de correo ubicados en la sala de espera.
- MTA (servidor de correo)
-
Un servidor de correo es un programa que envía y recibe
correo electrónico. Alaveteli envía correo a nombre de sus usuarios y procesa
las respuestas que recibe.
Todos los mensajes pasan por el servidor de correo, que constituye un servicio
independiente de su sistema.
Más información:
- Consulte estas instrucciones para configurar su MTA (incluye ejemplos para exim4 y postfix, dos de los más comunes)
-
archivo
.po
(y archivo.pot
) -
Estos son los archivos requeridos por el mecanismo gettext que Alaveteli utiliza para
la localización. Un archivo
.pot
contiene una lista con todas las cadenas de texto propias de la aplicación que necesitan ser traducidas. Cada archivo.po
contiene la correspondencia entre estas cadenas, utilizadas como claves, y sus traducciones para un idioma en concreto. La clave se denomina msgid y su correspondiente traducción, msgstr.Más información:
- Consulte la traducción de Alaveteli para obtener una visión general desde el punto de vista de un traductor.
- Consulte la internacionalización de Alaveteli para acceder a detalles más técnicos.
- Alaveteli se halla en el sitio web Transifex, que permite a los traductores trabajar con Alaveteli en un navegador, sin necesidad de preocuparse por su estructura subyacente.
- servidor de producción
-
Un servidor de producción es aquel donde se mantiene en funcionamiento su sitio web basado en Alaveteli
para usuarios auténticos con datos reales. Es diferente de un
servidor de desarrollo, que se utiliza para llevar a cabo
modificaciones de entorno y personalización e intentar que todo funcione correctamente, así como de un
servidor de pruebas, utilizado para probar y configurar
el código ya finalizado antes de su publicación.
Su servidor de producción debe configurarse para funcionar de la forma más eficiente posible. Por ejemplo, con la memoria caché activada y la depuración desactivada. Rails cuenta con un «modo de producción», que se encarga de ello, solo debe asignar a
STAGING_SITE
el valor0
. Tenga en cuenta que si modifica esta opción después de la implementación, el archivorails_env.rb
, que permite el modo de producción de Rails, no se creará hasta que ejecuterails-post-deploy
.Si dispone de un servidor de pruebas, los entornos de sistema de sus servidores de pruebas y de producción deberían ser idénticos.
En ningún caso debería necesitar editar código directamente en su servidor de producción. Le recomendamos encarecidamente el uso del mecanismo de implementación de Alaveteli (mediante Capistrano) para efectuar cambios en su servidor de producción.
</dd> - publicar
- Alaveteli trabaja mediante la publicación de las respuestas que recibe para las solicitudes de información pública enviadas por sus usuarios. Para ello procesa los correos electrónicos recibidos y los presenta como páginas (una por solicitud) en el sitio. Esto facilita que la gente encuentre, lea, enlace y comparta la solicitud y la información proporcionada como respuesta.
- recaptcha
-
El mecanismo recaptcha permite detectar a usuarios no humanos,
como robots automatizados, para evitar que envíen solicitudes de forma automática.
Requiere que el usuario (humano) identifique un patrón de letras mostrado
en una imagen, una tarea prácticamente imposible para los robots no humanos.
Alaveteli utiliza esta herramienta para evitar recibir spam.
Más información:
-
Utilice las opciones de configuración
RECAPTCHA_PUBLIC_KEY
yRECAPTCHA_PRIVATE_KEY
para configurarlo. - Consulte el sitio de recaptcha para obtener más información.
-
Utilice las opciones de configuración
- editar (o edición)
-
Al editar se elimina u oculta parte de un mensaje
para que no pueda leerse, se retira parte de un documento del sitio web.
Esta tarea puede ser necesaria por diversas razones. Por ejemplo, es posible que un usuario incluya por error información personal en su solicitud o que una autoridad la incluya en su respuesta. También es posible que necesite editar partes de solicitudes y respuestas que resulten difamatorias o puedan herir la sensibilidad.
Más información:
- Consulte el manual de administrador para obtener más detalles sobre cómo y cuándo es posible que necesite editar información.
- Puede llevar a cabo la edición exclusivamente de texto con las normas de censura de Alaveteli.
- Algunos temas son más sencillos de editar que otros (en particular, los archivos PDF pueden contener firmas o imágenes difíciles de eliminar de forma parcial). El tal caso es posible que necesite eliminar el documento en su totalidad.
- expresión regular
-
Una expresión regular es una forma concisa de describir un
patrón o secuencia de caracteres, letras o palabras. Un administrador encontrará
prácticas las expresiones regulares cuando necesite definir normas de censura. Por ejemplo, en lugar
de editar solamente una frase específica,
puede describir un conjunto completo de frases similares con una sola
expresión regular.
Las expresiones regulares pueden resultar complejas, pero también potentes. Si no está familiarizado con su uso, es fácil cometer errores. ¡Úselas con precaución!
Más información:
-
Por ejemplo, la expresión regular
Jo(e|ey|seph)\s+Blogg?s
incluiría «Joe Bloggs
», «Joey Bloggs
» y «Joseph Bloggs
», pero no «John Bloggs
». - Consulte las expresiones regulares en wikibooks para obtener más información
-
Por ejemplo, la expresión regular
- actualización (o gestor de actualizaciones)
-
Publicamos nuevas actualizaciones de código para Alaveteli siempre que se
añaden trabajos importantes (nuevas funcionalidades, mejoras, soluciones de errores, etc.) al
código principal. Las actualizaciones se identifican con una etiqueta, que incluye dos o tres
números: mayor, menor y, en caso necesario, el número de parche.
Le recomendamos utilizar siempre la última versión. El proceso es supervisado por el
gestor de actualizaciones de Alaveteli, encargado de decidir qué
cambios deben incluirse en la actualización actual y la fecha límite del trabajo.
Actualmente se trata del desarrollador principal de Alaveteli en mySociety.
Más información:
- La última actualización estable se halla en la rama maestra.
- Consulte la lista de actualizaciones y sus etiquetas específicas.
- También intentamos coordinar las actualizaciones con todos los trabajos activos de traducción. Consulte la traducción de Alaveteli para obtener más información.
- Le animamos a utilizar el mecanismo de implementación, que permite mantener actualizado el servidor de producción con facilidad.
- solicitud
- En Alaveteli se denomina solicitud a la petición de información pública que un usuario envía y que el sitio manda por correo electrónico a la autoridad correspondiente. Alaveteli publica automáticamente las respuestas a todas las solicitudes enviadas.
- respuesta
- Se denomina respuesta al correo electrónico enviado por una autoridad como contestación a la solicitud de un usuario.
- Ruby on Rails (también llamado «Rails»)
-
Alaveteli está escrito en el lenguaje de programación Ruby mediante la
estructura de aplicación web «Ruby on Rails».
Más información:
- Sitio web de Ruby on Rails.
- La estructura de directorios de Alaveteli recibe influencias del uso de Ruby on Rails.
- Sass (para la generación de CSS)
-
Las hojas de estilo en cascada (CSS) de Alaveteli controlan la apariencia de las páginas y
se definen utilizando Sass. Técnicamente se trata de una extensión del lenguaje CSS
y lo utilizamos porque resulta más sencillo que el uso directo de CSS
(por ejemplo, Sass permite realizar un solo cambio y que este se aplique a numerosos
elementos ubicados en todo el sitio).
Rails detecta los cambios realizados
en cualquier archivo Sass y genera de nuevo automáticamente los archivos CSS utilizados por el sitio.
Más información:
- Sitio web de Sass.
- Más detalles sobre la modificación de su esquema de colores, que utiliza Sass.
- servidor de pruebas
-
Un servidor de pruebas se utiliza para probar el código o la configuración
antes de publicar el sitio. Es diferente de un servidor de desarrollo, donde se modifican el código y las opciones
para conseguir que todo funcione, así como de un
servidor de producción, que es el lugar
visitado por los usuarios donde se hallan los datos reales.
En el servidor de pruebas debe asignar a
STAGING_SITE
el valor1
.Si dispone de un servidor de pruebas, los entornos de sistema de sus servidores de pruebas y de producción deberían ser idénticos.
En ningún caso debería necesitar editar código directamente en sus servidores de producción y de pruebas. Le recomendamos encarecidamente el uso del mecanismo de implementación de Alaveteli (mediante Capistrano) para efectuar cambios en ellos.
- estado
-
Cada solicitud pasa por distintos
estados a medida que progresa a través del sistema.
Los estados ayudan a los administradores de Alaveteli, así como al público,
a comprender la situación actual respecto a cualquier solicitud y a saber qué
acción se requiere en cada momento.
Los estados disponibles pueden personalizarse dentro del tema de su sitio.
Más información:
- Estados de ejemplo de WhatDoTheyKnow (sitio basado en Alaveteli en funcionamiento en el Reino Unido).
- Como comparación, consulte los estados de ejemplo de InformataZyrtare (sitio basado en Alaveteli en funcionamiento en Kosovo).
- Para personalizar o añadir sus propios estados, consulte la personalización de los estados de solicitud.
- tema
-
Se denomina tema al conjunto de modificaciones realizadas en las plantillas
y en el código que proporcionan al sitio un aspecto o un comportamiento distintos
al predeterminado. Normalmente necesitará un tema para que Alaveteli muestre su propia marca.
Más información:
</dl>