From 53fc8e3442b7adf18554a1038f6b35965451fb84 Mon Sep 17 00:00:00 2001
From: KyMAN <0kyman0@gmail.com>
Date: Tue, 5 Mar 2024 15:09:37 +0100
Subject: [PATCH] =?UTF-8?q?#wip:=20Documentaci=C3=B3n=20y=20purebas=20de?=
=?UTF-8?q?=20viabilidad.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.gitignore | 3 +-
Public/tests/mapa.test.html | 158 ++++++++++++++++++++++++++++++++++++
README.md | 97 +++++++++++++++++++++-
version | 1 +
4 files changed, 257 insertions(+), 2 deletions(-)
create mode 100644 Public/tests/mapa.test.html
create mode 100644 version
diff --git a/.gitignore b/.gitignore
index 3247827..4dfb623 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
[Ss]ecrets
Data
-CaritasSantaCruz.Mapeate.apache2.conf
\ No newline at end of file
+CaritasSantaCruz.Mapeate.apache2.conf
+Public/data
\ No newline at end of file
diff --git a/Public/tests/mapa.test.html b/Public/tests/mapa.test.html
new file mode 100644
index 0000000..91ad3f3
--- /dev/null
+++ b/Public/tests/mapa.test.html
@@ -0,0 +1,158 @@
+
+
+
+ Mapa - Pruebas
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/README.md b/README.md
index 0c2f909..fb9b46d 100644
--- a/README.md
+++ b/README.md
@@ -77,9 +77,104 @@ DC -.- DI
```
+## Comprobación de viabilidad
+
+El mayor problema al que nos enfrentamos con este proyecto es a conseguir los mapas requeridos en SVG con los territorios independientes e identificados dentro del propio XML del SVG; y tras ello, la carga e interpretación dinámica en HTML de los mismos, así como su gestión de eventos de forma dinámica y la manipulación del diseño.
+
+Empezando por las fuentes, necesitamos mapas SVG con licencia libre, gratuita y abierta pues alteraremos la fuente origen y como proyecto totalmente sin ánimo de lucro, no podemos depender de pagos a terceros. En este caso se hará uso de [MediaWiki Commons](https://commons.wikimedia.org/wiki/Main_Page), un sitio Web con contenidos libres de Internet que complementa en gran medida a la propia Wikipedia, nacida del propio nombre de la plataforma Free OpenSource [MediaWiki](https://www.mediawiki.org/).
+
+> Pese a que muchos de los contenidos están bajo MIT, Full CopyLeft o directamente sin licencia, nosotros nombraremos y atribuiremos la autoría de la fuente original por respeto a quienes comparten contenidos en ayuda común y su trabajo.
+
+El mapa inicial de pruebas será el siguiente:
+
+- https://es.m.wikipedia.org/wiki/Archivo:BlankMap-World.svg
+
+[](https://upload.wikimedia.org/wikipedia/commons/4/4d/BlankMap-World.svg)
+
+Ahora, hemos de crear un directorio de pruebas en el Public del proyecto con un simple HTML que cargue de forma dinámica en un marco dicho mapa y mediante JavaScript y CSS, alterarlo verificando la funcionalidad del proyecto.
+
+### Resultados
+
+La carga dinámica del mapa así como la capacidad de modificar a nivel de estilos y funcional cada uno de los elementos es totalmente viable, sin embargo, a modo puzzle, lo que viene siendo e Drag&Drop es un problema por el tipo de posicionamiento de los elementos del SVG. La prueba realizada la encontramos en la siguiente direccion local:
+
+- [/tests/mapa.test.html](/tests/mapa.test.html)
+
+> La prueba tienen todo integrado internamente, incluyendo el CSS y JS y depende de que esté descargado el mapa de la WikiMedia Commons en /Public/data con el nombre de "World Map.svg".
+
+Para poder trabajar correctamente los mapas hemos de saber las siguientes tecnologías basadas en el ámbito de desarrollo Web:
+
+- **HTML**
+- **CSS**: No sólo el estándar, sino el específico para los elementos del SVG.
+- **JavaScript**
+ - **DOM**: Framework para trabajar XML, en este caso para trabajar y orientarnos en la estructura del HTML, que incluye también el SVG.
+ - **XMLHttpRequest**: Objeto para gestionar comunicaciones asíncronas.
+ - **Expresiones Regulares**: Librería interna de trabajo para patrones de texto. *Se usará para adaptar el XML del SVG al entorno Web de trabajo.*
+
## Referencias
- Web [VirusTotal](https://www.virustotal.com/) para validación vía Antivirus de Malwares en ficheros - https://www.virustotal.com/
- Reproductores Flash:
- [Adobe Flash Player](https://www.adobe.com/es/products/flashplayer/end-of-life.html) - https://www.adobe.com/es/products/flashplayer/end-of-life.html.
- - Emulador Flash [Ruffle](https://ruffle.rs/) - https://ruffle.rs/
\ No newline at end of file
+ - Emulador Flash [Ruffle](https://ruffle.rs/) - https://ruffle.rs/
+- Docker
+ - [Web oficial](https://www.docker.com/) - https://www.docker.com/
+ - [Wikipedia](https://es.wikipedia.org/wiki/Docker_(software)) - https://es.wikipedia.org/wiki/Docker_(software)
+- Debian
+ - [Web oficial](https://www.debian.org/) - https://www.debian.org/
+ - [Repositorio Git oficial](https://sources.debian.org/) - https://sources.debian.org/
+ - [Wikipedia](https://es.wikipedia.org/wiki/Debian_GNU/Linux) - https://es.wikipedia.org/wiki/Debian_GNU/Linux
+- Apache2
+ - [Web oficial](https://httpd.apache.org/) - https://httpd.apache.org/
+ - [Wikipedia](https://es.wikipedia.org/wiki/Servidor_HTTP_Apache) - https://es.wikipedia.org/wiki/Servidor_HTTP_Apache
+ - [Repositorio Git oficial](https://github.com/apache/httpd) - https://github.com/apache/httpd
+- PHP
+ - [Web oficial](https://es.wikipedia.org/wiki/PHP) - https://es.wikipedia.org/wiki/PHP
+ - [Wikipedia](https://www.php.net/) - https://www.php.net/
+ - [Repositio Git oficial](https://github.com/php/php-src) - https://github.com/php/php-src
+- JavaScript
+ - JavaScript en la [W3Schools](https://www.w3schools.com/js/) - https://www.w3schools.com/js/
+ - JavaScript en [Mozilla](https://developer.mozilla.org/es/docs/Web/JavaScript) - https://developer.mozilla.org/es/docs/Web/JavaScript
+ - Web de aprendizaje [LenguajeJS](https://lenguajejs.com/) - https://lenguajejs.com/
+ - JavaScript original
+ - [Wikipedia](https://es.wikipedia.org/wiki/JavaScript) - https://es.wikipedia.org/wiki/JavaScript
+ - ECMAScript
+ - [Web de estasndarización](https://ecma-international.org/) - https://ecma-international.org/
+ - [Wikipedia](https://es.wikipedia.org/wiki/ECMAScript) - https://es.wikipedia.org/wiki/ECMAScript
+- HTML
+ - ["Wikipedia](https://es.wikipedia.org/wiki/HTML) - https://es.wikipedia.org/wiki/HTML
+ - [Wikimedia Commons](https://commons.wikimedia.org/wiki/Category:HTML) - https://commons.wikimedia.org/wiki/Category:HTML
+ - [Web oficial](https://www.w3.org/html/) - https://www.w3.org/html/
+ - HTML en la [W3Schools](https://www.w3schools.com/html/) - https://www.w3schools.com/html/
+ - HTML en [Mozilla](https://developer.mozilla.org/es/docs/Web/HTML) - https://developer.mozilla.org/es/docs/Web/HTML
+- CSS
+ - [Wikipedia](https://es.wikipedia.org/wiki/CSS) - https://es.wikipedia.org/wiki/CSS
+ - CSS en la [W3Schools](https://www.w3schools.com/css/) - https://www.w3schools.com/css/
+ - CSS en [Mozilla](https://developer.mozilla.org/es/docs/Web/CSS) - https://developer.mozilla.org/es/docs/Web/CSS
+ - CSS en la [W3](https://www.w3.org/Style/Examples/011/firstcss.es.html) - https://www.w3.org/Style/Examples/011/firstcss.es.html
+ - SASS
+ - [Web oficial](https://sass-lang.com/) - https://sass-lang.com/
+ - [Wikipedia](https://es.wikipedia.org/wiki/Sass) - https://es.wikipedia.org/wiki/Sass
+ - [Repositorio Git oficial](https://github.com/sass/sass) - https://github.com/sass/sass
+ - [Repositorio Node oficial](https://www.npmjs.com/package/sass) - https://www.npmjs.com/package/sass
+- SVG
+ - [Wikpedia](https://es.wikipedia.org/wiki/Gr%C3%A1ficos_vectoriales_escalables) - https://es.wikipedia.org/wiki/Gr%C3%A1ficos_vectoriales_escalables
+ - SVG en la [W3](https://www.w3.org/Graphics/SVG/) - https://www.w3.org/Graphics/SVG/
+ - SVG en [Mozilla](https://developer.mozilla.org/es/docs/Web/SVG) - https://developer.mozilla.org/es/docs/Web/SVG
+- Nginx
+ - ["web oficial](https://www.nginx.com/) - https://www.nginx.com/
+ - [Repositorio](https://hg.nginx.org/nginx) - https://hg.nginx.org/nginx
+ - [Wikipedia](https://es.wikipedia.org/wiki/Nginx) - https://es.wikipedia.org/wiki/Nginx
+ - Free Nginx
+ - [Web oficial](https://freenginx.org/) - https://freenginx.org/
+- MySQL
+ - [Web oficial](https://www.mysql.com/) - https://www.mysql.com/
+ - [Wikipedia](https://es.wikipedia.org/wiki/MySQL) - https://es.wikipedia.org/wiki/MySQL
+ - [Repositio Git oficial](https://github.com/mysql/mysql-server) - https://github.com/mysql/mysql-server
+ - [Driver PDO para PHP](https://www.php.net/manual/es/ref.pdo-mysql.php) - https://www.php.net/manual/es/ref.pdo-mysql.php
+ - MariaDB
+ - [Web oficial](https://mariadb.org/) - https://mariadb.org/
+ - [Wikipedia](https://es.wikipedia.org/wiki/MariaDB) - https://es.wikipedia.org/wiki/MariaDB
+ - [Repositorio Git oficial](https://github.com/MariaDB/server) - https://github.com/MariaDB/server
+- Mapas
+ - [Países del mundo en SVG en Wikimedia Commons](https://es.m.wikipedia.org/wiki/Archivo:BlankMap-World.svg) - https://es.m.wikipedia.org/wiki/Archivo:BlankMap-World.svg
+ - *Hay más mapas en el mismo enlace facilitado de la Web.*
\ No newline at end of file
diff --git a/version b/version
new file mode 100644
index 0000000..7bcd0e3
--- /dev/null
+++ b/version
@@ -0,0 +1 @@
+0.0.2
\ No newline at end of file