Usuario:ManuelRomero/ProgramacionWeb/Distancia2018/Docker/ejemplo - Historial de revisiones

ManuelRomero: /* Preparación de un docker para la práctica */

2019-05-07T11:13:07Z

‎Preparación de un docker para la práctica

ManuelRomero: /* Creando los ficheros de texto */

2019-04-11T09:08:39Z

‎Creando los ficheros de texto

ManuelRomero: /* Funciones de gettext en php */

2019-03-20T08:59:43Z

‎Funciones de gettext en php

ManuelRomero: /* Funciones a usar para traducir */

2019-03-20T08:58:22Z

‎Funciones a usar para traducir

ManuelRomero: /* Preparación de un docker para la práctica */

2019-03-19T17:27:56Z

‎Preparación de un docker para la práctica

ManuelRomero: Página creada con «{{Usuario:ManuelRomero/ProgramacionWeb/Distancia2018/Docker/nav}} ===gettext()=== *Función en php que nos va a permitir tener nuestra página en varios lenguajes, lo que s...»

2019-03-14T16:16:48Z

Página creada con «{{Usuario:ManuelRomero/ProgramacionWeb/Distancia2018/Docker/nav}} ===gettext()=== *Función en php que nos va a permitir tener nuestra página en varios lenguajes, lo que s...»

Página nueva

{{Usuario:ManuelRomero/ProgramacionWeb/Distancia2018/Docker/nav}}
===gettext()===
*Función en php que nos va a permitir tener nuestra página en varios lenguajes, lo que se llama internacionalizar nuestra aplicación de una forma profesional
https://www.gnu.org/software/gettext/manual/gettext.html
http://www.albertlanchas.com/articulos/internacionalizacion-php-gettext

===Preparación de un docker para la práctica===
*Vamos a usar un docker límpio con volumen para realizar esta práctica
*De este modo repasaremos todos las herramientas que usamos habitualmente
;Instalamos docker con un directorio común entre contenedor y anfitrión (previamente lo creamos en local)
docker run --name xxxx -t -i -v host_paht:continer:path ubuntu:latest
<source lang=bash>
mkdir /var/www/idiomas1
docker run --name idiomas1 -t -i -v /var/www/html/idiomas1:/var/www/idiomas1 ubuntu:latest
</source>
;Cambiar los colores al hacer un ls de los directorios
*Editamos el ficheor .bashrc y agregamos la línea síguiente
<source lang=bash>
export PS1="\[$(tput setaf 1)\]\u@\h:\w $ \[$(tput sgr0)\]"
</source>
*Cargamos el fichero de configuración
<source lang=bash>
source .bashrc
</source>
o
<source lang=bash>
. .bashrc
</source>

;Actualizamos e instalamos apache2, php y el módulo de apache2 para intepretar código php:
*Después levantamos el servicio
<source lang=bash>
sudo apt-get update
apt-get install apache2 php libapache2-mod-php
service apache2 start
</source>

===Instalación de la librería para gestionar idiomas ===
*Para poder usar esta función debemos tener instalado el paquete de ubuntu identificado con el mismo nombre.
<source lang=bash>
apt-get install gettext
</source>
*Fichero de configuración de php (En mi caso)
/etc/php/7.2/apache/php.ini
y quitamos el comentario ''''';''''' de la extensión '''''gettext'''''
*Yo me instalo previamente '''''vim''''', por ser un editor que uso, se puede instalar y usaro otro editor como '''''nano''''', '''''pico'''''
<source lang=bash>
....
;extension=gd2
extension=gettext
;extension=gmp
....
</source>
*Reiniciamos servicio
<source lang=bash>
sudo service apache2 restart
</source>
;Para instalar los idiomas
<source lang=bash>
sudo apt-get install locales
</source>
Para ver los idiomas que tengo actualmente instalados miramos con el comando
<source lang=bash>
locale -a
</source>
Si queremos agregar nuevos idiomas ejecutamos la reconfiguración de los idiomas instalados
<source lang=bash>
# dpkg-reconfigure locales
</source>
*Nos aparece una lista de los locales disponibles y seleccionamos los que nos interesen.
*Vamos a agregar el español utf-8, el francés y el inglés para nuestra práctica.
son los códigos (los podemos ver en la lista) 158 182 233 respectivamente o 149 174 y 225, depende de versiones instaladas, en cualquiercaso mirar la lista

establecemos por defecto el es-ES-UTF8

===Estructura de dierectorios===
*Se trata de tener un directorio por cada idioma que queramos hacer traducir
*En concreto estableceremos los directorios de configuraciones regionales.
*Estos directorios se espera bajo '''''locale'''''
*Los nombres de cada directorio de cada idioma a de ser un nombre estandarizado
*Debemos usar las abreviaturas de las dos letras minúsculas del idioma según la especificación ISO-639-1, seguido de un guión bajo, seguido de las dos letras en mayúscula que corresponderán al código del país según la especificación ISO-3166-1.
*Podemos obtener una lista de las localizaciones instaladas en nuestro sistema
<source lang=bash>
locale -a
</source>
*Como ejemplo crearemos 3 idiomas (fr, en, es)
*Se crean directorios con el nombre
ii_PP
*'''''ii''''' son dos letras para especificar el idioma de acuerdo a la especificación ISO-639-1
*'''''PP''''' son dos letras en mayúsculas correspondinetes al país según la especificación ISO-3166-1
*Dentro de cada directorio crearemos el directorio '''''LC_MESSAGES'''''
[[Archivo:dir_idiomas.png]]

===Escribiendo el fichero del proyecto===
*Ahora vamos a ver cómo establecemos en el proyecto las cadenas que queremos traducir
*Para ello vamos lo que vamos a hacer, es en lugar de escribir la cadena de texto, para cada una de ellas vamos a usar un código de identificación que vamos a pasar a la función '''''gettext'''''.
*Por ejemplo si queremos poner un mensaje de bienvenida, querríamos escribir
<source lang=html5>
<h1>Bienvenido a este sitio web</h1>
</source>
*en lugar de ello escribiremos
<source lang=php>
<h1><?php echo gettext("WELLCOME"") ?></h1>
</source>
*El código del mensaje es '''''WELLCOME''''', por supuesto es un código elegido por nosotros, podemos poner lo que queramos, de lo que se trata, es que ya no escribiremos texto, si no códigos
*Alternativamente podemos usar el alias guión bajo '''''_''''' en lugar del nombre de la función '''''gettext''''', por comodidad
*Escribamos una web con diferentes textos que posteriormente traduciremos
<source lang=html5>

<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport"
content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title><?php echo _("WELLCOME") ?></title>

</head>
<body>
<h1><title><?php echo _("WELLCOME") ?></title></h1>
<h2><title><?php echo _("CHOOSE_LANGUAGE") ?></title></h2>
<form action="index.php">

<?php echo _("NAME") ?><input type="text" name="nombre"><br />
<?php echo _("PASS") ?><input type="text" name="pass"><br />
<input type="submit" value="<?php echo _("LOGIN") ?>" >
</form>
</body>
</html>
</source>

===Creando los ficheros de texto===
*Creamos los ficheros con el texto en el idioma específico. Son ficheros de texto con extensión '''''po'''''
*En este fichero lo que vamos a tener es el código del mensaje y su texto.
*Tendremos un fichero para cada idioma, de forma que según la configuración del idioma cojamos de un fichero u otro el texto que queremos que aparezca
*Las claves de este fichero son
'''''msgid''''' para establecer el código que hayamos puesto
'''''msgstr''''' para establecer el texto correspondiente a ese código en el idioma concreto que estemos estableciendo

*Para crearlo lo podemos hacer a mano, pero mejor es usar la herramienta '''''xgettext''''', con la que le decimos que extraiga
*Para ello nos ubicamos en el directorio del idioma. El fichero ha de existir, por lo que previamente lo creamos, lo podemos hacer con una sola instrucción
<source lang=bash>
touch messages.po | xgettext --language=PHP -j messages.po /var/www/idiomas/index.php
</source>
Si ahora abrimos el fichero vemos su contenido
<source lang=php>
# SOME DESCRIPTIVE TITLE.
# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2018-12-03 10:12+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"

#: /var/www/idiomas/index.php:20 /var/www/idiomas/index.php:24
msgid "WELLCOME"
msgstr ""

#: /var/www/idiomas/index.php:25
msgid "CHOOSE_LANGUAGE"
msgstr ""

#: /var/www/idiomas/index.php:28
msgid "NAME"
msgstr ""

#: /var/www/idiomas/index.php:29
msgid "PASS"
msgstr ""

#: /var/www/idiomas/index.php:30
msgid "LOGIN"
msgstr ""
</source>
*Lo podemos copiar para cada uno de los idiomasel mismo fichero y escrimos su contenido
</source>

*El resto de ficheros cambiaría el '''''msgstr''''' correspondiente.
*Una herramienta a usar puede ser poedit (Hay varias, esta parece que tiene mucha aceptación)
*Ahora debemos generar el fichero '''''mo''''' (Machine Object) a partir del '''''po''''' (Portable Object)
*Para ello podemos ejecutar
<source lang=bash>
msgfmt -o fichero.mo fichero.po
</source>
*O bien instalar el editor '''''poedit''''', hay mas.
<source lang=bash>
apt-get install poedit
</source>
La página oficial
https://poedit.net/

===Funciones a usar para traducir===
;bind_textdomain_codeset
:Especifica el juego de caracteres en que los mensajes del catálogo del dominio serán devueltos
;bindtextdomain
:Establece la ruta del dominio
;dcgettext
: Sobrescribe el dominio de la búsqueda única del mensaje
;dcngettext
: Versión plural de dcgettext
;dgettext
: Sobrescribe el dominio actual
;dngettext
: Versión plural de dgettext
;gettext
: Consultar un mensaje en el dominio actual
;ngettext
: Versión plural de gettext
;textdomain
: Establece el dominio actual
===Instalar el idioma===
https://es.stackoverflow.com/questions/98786/gettext-no-realiza-las-traducciones-en-web-php

@@ Línea 19: / Línea 19: @@
 {{MRM_Web|
   http://linux-sxs.org/housekeeping/lscolors.html
+}}
 <source lang=bash>

@@ Línea 231: / Línea 231: @@
 *No hay que especificar la extensión la cual ya está establecida mo (machine object)
   Valores en nuestro caso messages para el nombre del fichero y locale para el nombre del directorio
 ;Otras funciones que pueden ser de interés

@@ Línea 149: / Línea 149: @@
 *Para ello nos ubicamos en el directorio del idioma. El fichero ha de existir, por lo que previamente lo creamos, lo podemos hacer con una sola instrucción
 <source lang=bash>
-touch messages.po | xgettext --language=PHP -j messages.po /var/www/idiomas/index.php
+touch messages.po | xgettext --language=PHP --from-code=UTF-8 -j messages.po /var/www/idiomas/index.php
 </source>
 Si ahora abrimos el fichero vemos su contenido

@@ Línea 209: / Línea 209: @@
   https://poedit.net/
-===Funciones a usar para traducir===
+===Funciones de gettext en php===
 ;bind_textdomain_codeset
 :Especifica el juego de caracteres en que los mensajes del catálogo del dominio serán devueltos
 ;dcgettext
 : Sobrescribe el dominio de la búsqueda única del mensaje
@@ Línea 228: / Línea 249: @@
 ;textdomain
 : Establece el dominio actual
 ===Instalar el idioma===
 https://es.stackoverflow.com/questions/98786/gettext-no-realiza-las-traducciones-en-web-php

@@ Línea 11: / Línea 11: @@
   docker run --name xxxx -t -i -v host_paht:continer:path ubuntu:latest
 <source lang=bash>
 docker run --name idiomas1 -t -i -v /var/www/html/idiomas1:/var/www/idiomas1 ubuntu:latest
 </source>
 ;Cambiar los colores al hacer un ls de los directorios
-*Editamos el ficheor .bashrc y agregamos la línea síguiente
+*A veces los colores que se ven al listar los ficheros y directorios no son los que más nos gustan, pero podemos adaptarlos modificando nuestro fichero de configuración de '''''bash'''''.
 <source lang=bash>
- export PS1="\[$(tput setaf 1)\]\u@\h:\w $ \[$(tput sgr0)\]"
+alias ls='ls --color'
 </source>
 *Cargamos el fichero de configuración