Guía de instalación / Installation guide

[arturomechan]

Por favor podrían poner una pequeña guía de instalación.

• Requisitos del servidor.
• Bases de datos?.
• Documentos que cambiar para personalizar.
• Documentos a traducir para nuevos idiomas (puedo ayudar con el Asturiano).

Please could put a small installation guide.

• Server requirements.
• Databases?.
• Documents you change to customize.
• Documents to be translated into new languages ​​(I can help with Asturian).

[bertocq]

Hola @arturomechan tenemos esto en mente, por ahora la información esta algo desperdigada:

• Requisitos del Servidor: En esto no tengo una respuesta, quizás @voodoorai2000 o @xuanxu te puedan ayudar, pero nada "fancy" me imagino.

• Base de datos: Actualmente cónsul usa la librería pg para bases de datos PostgreSQL.

• Documentos que cambiar para personalizar: En el fichero CUSTOMIZE_ES.md que puedes encontrar en el directorio raiz.

• Documentos a traducir: Todos los .yml que se encuentran en config/locales (aunque en breves la estructura cambiará un poco [WIP] Localization files refactor #1694). Estamos en proceso de habilitar una herramienta para que gente no-técnica pueda contribuir a añadir más traducciones: https://crowdin.com/project/consul, este lunes van a solucionar un problema interno y podremos empezar a incluir más idiomas fácilmente. Sin duda tu ayuda será muy bienvenida con el asturiano :) 👏

PD: Siempre se agradecen PR's para mejorar la documentación actual, es una parte muy importante de todo proyecto :)

===

Hey @arturomechan we've this in backlog/mind, but currently info is still scattered:

• Server requirements: I don't know about this, but for sure @voodoorai2000 or @xuanxu can tell.

• Database: As you can see at the Gemfile consul uses the pg gem adapter to connecto to PostgreSQL database.

• Files to customize: You can find an almost complete guide at the CUSTOMIZE_EN.md file in the root directory.

• Files to translate: All the .yml files under config/locales directory (although that structure is changing a bit in a few: [WIP] Localization files refactor #1694).

We're currently configuring a platform that will allow non-tech people to contribute with translations: https://crowdin.com/project/consul, this monday they're fixing an internal issue that go us stuck. Your help to get Asturian translation will be really welcome :) 👏

PS: PR's are always welcome to improve our documentation! Its a really important of each project! :)

[bertocq]

@arturomechan about the guide implementation, our roadmap / idea is the following:

1. Get a consensus in the contents and index (chapters organization), normally this starts with a proposal that gets discussed.
2. Start a new repo under this organization linked to a gitbook that easily lets non-tech people both read/update, but also can be updated through git/github.
3. Add existing documentation, and start individual issues for pending chapters, hopefully some of them can be covered by contributors.

[arturomechan]

Gracias por toda la información @bertocq (deberíamos tener vida y no trabajar un domingo).
Yo soy una de esas personas no-tech (soy diseñador gráfico) aún que he trabajado con programadores (solía preparar el trabajo en html como base), pensaba que sería interesante crear un instalador para Softaculous o Fantástico que además de facilitar la instalación promueven el uso y por tanto las colaboraciones en el desarrollo.
Conocí Cónsul por la web de participación del Ayto. De Oviedo, y me parece que es también muy útil para asociaciones y otros grupos de trabajo.

Thanks for all the information @bertocq (we should have life and not work a Sunday).
I'm one of those non-tech people (I'm a graphic designer), even though I've worked with programmers (used to prepare the work in html as a base), I thought it would be interesting to create an installer for Softaculous or Fantastico that, besides facilitating installation, use and therefore the collaborations in the development.
I met Cónsul on the web page of the Ayto de Oviedo, and I think it is also very useful for associations and other working groups.

[bertocq]

Thanks @arturomechan! We're a very small core team that work for Madrid fork and as a collateral effect maintain this Open-source project. Doing a installer would be awesome but its far from the core improvementa and features we have on roadmaps.

Anyway for local development its as easy as following the guide we've at https://github.com/consul/consul/blob/master/doc/es/dev_test_setup.md

Consul is still a platform that needs a technical person to install and maintain, but hopefully and with the help of contributors that will soon change

Please if you have questions or trouble with local install go talk with us at https://gitter.im/consul/consul 🤗👍

[bertocq]

@arturomechan I suppose its not the installer you where referring to, but @voodoorai2000 just refreshed my memory... we've on the works an automated production environment setup #1491

[arturomechan]

@bertocq Muy interesante y útil, gracies! / Very interesting and useful, thanks!

[arturomechan]

Sorry

[bertocq]

Hey @arturomechan any email/twitter/etc to contact you in private? I'm @bertocq at almost every single service you can imagine :) (gmail, twitter, telegram, skype, hangout, gitter, etc...) Ping me and we'll talk about Asturian translations! https://crowdin.com/project/consul/ast#

[arturomechan]

I sent you a private route by gmail

[voodoorai2000]

Closed in favor of #1778