Compare commits

...

12 Commits

Author SHA1 Message Date
Team1 f5c9e8fd21 Added at the beginning the official repository link and added the updated git link of the docs repository. 2023-07-05 18:37:12 +00:00
p1r0 5f2176825e Merge pull request 'Added a short course on how to contribute to DCF. Issue #29 resolved.' (#30) from PaganoBarserker/docs:develop into develop
Reviewed-on: https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs/pulls/30
2023-06-23 00:43:04 +00:00
PaganoBarserker b8e2076f2f Greater description was added to the initial points.
Greater descriptions were added to the initial points to explain in a more improved and detailed manner how to successfully carry them out.
2023-06-16 18:29:58 +00:00
PaganoBarserker 87f8a38096 Some points were detailed
Added some points
2023-06-16 01:23:15 +00:00
Team1 8fc41354ec Added a short course on how to contribute to DCF. 2023-06-15 22:00:22 +00:00
Team1 6b7e25f74f Added a short course on how to contribute to DCF. 2023-06-15 21:55:41 +00:00
Team1 1fb02484aa Added a short course on how to contribute to DCF. 2023-06-15 21:54:17 +00:00
p1r0 a826ba3ec8 Merge pull request 'The issues #1 and #2 have been resolved.' (#28) from PaganoBarserker/docs:develop into develop
Reviewed-on: https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs/pulls/28
2023-06-08 17:40:06 +00:00
Team1 c8a8253316 The unordered enumeration in the document Taller de Git has been fixed, and ES or EN has been added to the file names accordingly. 2023-06-08 16:14:10 +00:00
Team1 f9b18b8100 The section of Lessons and Labs has been decentralized 2023-06-07 17:47:49 +00:00
Team1 518ede4a83 The section of Social Services / JCF Templates has been removed 2023-06-07 16:24:15 +00:00
David E. Perez Negron R c3d29521cf Merge tag '0.3.1' into develop
Decentralize the DCF Directory and other updates
2023-06-01 18:11:39 -06:00
6 changed files with 283 additions and 16 deletions

View File

@ -6,6 +6,8 @@ category: README
layout: post
---
### SUBMIT ISSUES, PULL REQUESTS, and others at the [OFFICIAL REPOSITORY](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs)
:space_invader:
[![GNUv1.3 License](https://img.shields.io/badge/License-GNU%20v1.3-yellow.svg)](https://opensource.org/licenses/) [![GitHub contributors](https://img.shields.io/github/contributors/decentralizedclimate/docs.svg?style=flat)]() :space_invader:
@ -98,7 +100,7 @@ Remember that the last command is to run the website and verify that the contrib
"Verify that there are no issues in Docs Project DCF that address the contribution or problem you wish to collaborate on (as it may have already been started by another user)."
You can check the issues at the following [**link:**](https://github.com/DECENTRALIZEDCLIMATE/docs/issues)
You can check the issues at the following [**link:**](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs/issues)
#### :artificial_satellite: "How to create a proposal or an issue:" :artificial_satellite:
@ -147,14 +149,14 @@ It is important to provide all relevant information so that others can understan
### :speech_balloon: How to contribute after creating my issue :speech_balloon:
You must clone the [docs](https://github.com/DECENTRALIZEDCLIMATE/docs) repository to your computer (having the necessary tools and packages to run Jekyll on your computer).
You must clone the [docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs) repository to your computer (having the necessary tools and packages to run Jekyll on your computer).
>If you don't have what is necessary to run the repository, you can install what is pertinent for [Jekyll](https://jekyllrb.com/docs/) by clicking on the link.
When you have the repository perfectly installed and configured, you create, improve or solve your issues and send screenshots in the same issue (as responses to it) where we can see the changes and that it works.
>If you need to access the [Issues](https://github.com/orgs/DECENTRALIZEDCLIMATE/projects/1) section of DCF again, you can click on the link.
>If you need to access the [Issues](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs/issues) section of DCF again, you can click on the link.
Send a Pull Request to the Develop branch of DCF docs, filling in the requirements, such as a brief title and comments on what was done. If everything is approved, your issue will be marked as completed and the changes will be added to the project.

View File

@ -3,7 +3,7 @@
"facebook": false,
"google": false,
"github": true,
"github_link": "https://github.com/DECENTRALIZEDCLIMATE",
"github_link": "https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs",
"telegram": true,
"telegram_link": "https://t.me/decentralizedclimate",
"instapaper": false,

View File

@ -60,7 +60,7 @@
<li>
<a href="https://github.com/DECENTRALIZEDCLIMATE/docs" target="blank" class="gitbook-link">
<a href="https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs" target="blank" class="gitbook-link">
Fork it Now!
</a>
</li>

View File

@ -10,15 +10,14 @@ layout: post
| Document | Last Update |
| -------- | -------- |
| [WorkFlow Model]({% post_url socialserv/2023-01-27-socialServicesWorkFlowModel %}) | 2023-01 |
| [WorkFlow Model EN]({% post_url socialserv/2023-01-27-socialServicesWorkFlowModel %}) | 2023-01 |
## Lessons & Labs
| Document | Last Update |
| -------- | -------- |
| [Git & Gitflow ES](https://hackmd.io/DbzfZuFuSvauJT3-zhO5pg) | 2023-02-22 |
| [Web3 Static ES](https://hackmd.io/gbfcNdtPTNy4jz60-8Fqpw) | 2023-02-24 |
| [UML](https://hackmd.io/GPbCktdZQ-CulhYgddcHPw) | 2023-03 |
| [Git & Gitflow ES]({% post_url socialserv/2023-02-22-GitES %}) | 2023-02-22 |
| [Web3 Static ES]({% post_url socialserv/2023-02-24-Web3StaticES %}) | 2023-02-24 |
> Note: Fix and update links as posts when finished
@ -29,10 +28,3 @@ layout: post
| [Git & GitFlow ES]({% post_url socialserv/2023-03-15-gitflowCheetSheet_ES %}) | 2023-02-16 |
| [Git & GitFlow EN]({% post_url socialserv/2023-03-15-gitflowCheetSheet_EN %}) | 2023-02-16 |
## Social Services/ JCF templates
| Document | Last Update |
| -------- | -------- |
| [Bitacora Gustavo](https://hackmd.io/vnhr3g1wT6Wg3wPvSQRdqg) | 2023-01-30|

View File

@ -0,0 +1,203 @@
---
title: Taller de Git & GitFlow
author: Decentralized Climate Foundation
date: 2023-02-22
category: socialservice
layout: post
---
El proposito del siguiente documento es aprender mientras se utiliza git y gitflow, en especial para trabajos colaborativos.
## Proceso
Los siguientes pasos serian:
0.- Crear cuenta en [git DCF](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs).
Para crear la cuenta se necesita un correo electrónico y un nombre de usuario, despues presionas en la esquina superior derecha el <**Registro**> e ingresas tu correo de registro, nombre de usuario <**Nombre**> y contraseña **<Contraseña>**.
De esta forma tendras tu propia cuenta dentro de la plataforma git de DCF y clonar los repositorios de la Fundacion para contribuir.
1.- Crear un Issue en [git DCF](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs) con un titulo breve sobre el tema <**Titulo brevemente**> , nombre del estudiante. <**Nombre del Estudiante**> y una descripción <**Descripción**> mas detallada sobre el caso o mejora que se desea realizar.
2.- Hacer un Fork del repositorio [docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs) del git de DCF, el cual podemos realizar al clickear el boton en la parte superior derecha donde dice Fork, ahi podemos cambiarle el titulo (Se recomienda mantenerlo y solo aceptar el fork a nuestro repositorio).
3.- Clonar el repositorio e implementar git flow (cambiar a la rama develop).
Se debe tener un acceso a VPN y pedir una Shell Contacte al [Sysadmin](mailto:david@decentralizedclimate.org) se sugiere el uso de [OpenVPN Connect](https://openvpn.net/client/client-connect-vpn-for-windows/), para el uso de la Shell que se envie, tambien se sugiere el uso de [MobaXterm](https://mobaxterm.mobatek.net/)
Despues de tener todo lo necesario, se siguen los pasos siguientes:
1.- Se conecta a la VPN ingresando el archivo ssh a sesiones existentes dentro de OpenVPN y despues ingresa la contraseña proporcinada por el Sysadmin.
2.- Se ejecuta MobaXterm y se siguen los siguientes comandos:
```shell
$ ssh pagano@10.162.235.52 #Se conecta uno a la VPN con el usuario que le proporcione el Sysadmin (el cual le pedira un usuario y una contraseña)
$ su [team numero] #Aqui se usara el team al que seas unido ejemplo si eres del team 2 deberas ingresar su team2
$ tmux a-t 0 # Si existe la sesion 0 que se creo previamente por otro usuario utilizar el comando de tmux a -t 0
```
>**Sugerencias:**
>**Si existe la sesion 0 que se creo previamente por otro usuario utilizar el comando de tmux a -t 0**
>**tmux ls - Lista sesiones activas de tmux**
>**Si estas dentro de tmux para salir utiliza Ctrl+b despues apretar d para no cerrar la sesion de todo.**
Cuando tengas tu VPN y Shell podras iniciar sesion y dentro entrar al team1 y al
```shell
$ git clone https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs
```
Entramos al proyecto git clonado en la maquina y vamos al archivo correspondiente en la ruta: docs/posts/socialserv/
```shell
$ cd docs
```
4.- Abrimos el Feature a partir de la la rama develop
para esto debemos pasarnos a la rama develop con el comando:
```shell
$ git checkout develop
$ $ git flow feature start MYFEATURE (MYFEATURE se cambia por el nombre que quieras identificarlo).
```
Entramos al archivo correspondiente:
```shell
$ cd _posts/socialserv/
```
Se editara el documento (en este ejemplo 2023-02-22-GitES.md) poniendo el comando del editor vim (**para el ejemplo seria: vim 2023-02-22-GitES.md**) pulsando `i` y empezamos a editar el documento.
>Se adjunta un Cheat Sheet de vim para guiarte y editar de forma correcta y eficiente el archivo en vim.
```shell
# Cheat Sheet de Comandos Básicos de Vim
Modo Normal:
- `i` - Cambiar al modo de inserción.
- `x` - Eliminar el carácter actual.
- `dd` - Eliminar la línea actual.
- `yy` - Copiar la línea actual.
- `p` - Pegar el contenido copiado o eliminado después de la línea actual.
- `u` - Deshacer la última acción.
- `Ctrl + r` - Rehacer la última acción deshecha.
- `:w` - Guardar el archivo.
- `:q` - Salir de Vim.
- `:q!` - Salir de Vim sin guardar cambios.
Modo de Inserción:
- `Esc` - Cambiar al modo normal.
Modo de Comando:
- `:set number` - Mostrar números de línea.
- `:set nonumber` - Ocultar números de línea.
- `:set tabstop=4` - Establecer el tamaño de la pestaña en 4 espacios.
- `:set expandtab` - Utilizar espacios en lugar de tabulaciones.
- `:set autoindent` - Habilitar la indentación automática.
- `:set syntax=python` - Establecer la sintaxis resaltada para Python (sustituir "python" por el lenguaje correspondiente).
- `:help <comando>` - Mostrar la ayuda sobre el comando especificado.
```
Puedes agregar, editar o mejorar el documento asi como estudiar el cheetsheet de gitflow y de gitlab.
>Puedes tener una terminal abierta en **tmux** asi tendremos corriendo el servidor mientras editamos, esto se realizaria con bundle.
> Verifica que bindle este instalado con el comando siguiente: **bundle --version**
Si no esta instalado puede seguir estos pasos:
```shell
gem install bundler
```
Lo corremos para visualizar los cambios en el conteneder de la VPN http://ip:puerto
> Ejemplo: http://10.162.235.52:4000/
Luego que todo podemos agregar los cambios cerrando el documento con Ctrl + x y despues con el comando:
```shell
$ git add .
```
> Antes de agregar algo, recuerda estar en la raiz del proyecto git en este caso **docs**
Con esto agregamos el archivo o archivos modificados al area de preparacion.
Despues debemos crear el commit con los cambios agregados.
Después de ejecutar git add ., puedes crear un commit utilizando el comando git commit -m "mensaje del commit". Al hacerlo, se crea un nuevo commit que contiene los cambios registrados en el área de preparación. El mensaje del commit proporcionado después del parámetro -m describe los cambios realizados en el commit.
```shell
$ git commit -m "Mensaje"
```
> Aclara que se modifico, agrego o mejoro en el commit brevemente pero conciso.
5.- Al terminar el Feature debemos hacer el push con referencia.
```shell
git push origin feature
```
Esto enviará los cambios de la rama **feature** al repositorio remoto llamado **origin**. Asegúrate de reemplazar "feature" con el nombre de tu rama.
Terminamos el Feature hacia la rama develop (la rama de donde partio todo).
Por buena practica se recomienda hacer primero un pull y despues nuestro respectivo push.
```sh
$ git flow feature pull origin MYFEATURE #MYFEATURE se reemplaza por el nombre que le pusiste al feature.
$ git feature finish
```
Puedes comprobar que tu commit esta ya en la rama develop cuando hagas uso del comando:
```shell
$ git log
```
El cual nos da un historial de los commits del proyecto con los datos de quien lo hizo a que hora y la fecha.
```sh
git push
```
Esto nos pedira nuestro usuario y un codigo ssh que nos proporciona el mismo git.
> El ssh lo puedes generar al entrar a [Configuracion ~ Aplicaciones] le ingresamos un nombre y generamos el codigo que sustituira a la contraseña.
Verifica que si se hizo el git push en tu repositorio forkeado en la pagina de gitDebes ingresar a tu repositorio y ver que el push fue agregado de forma correcta.
6.- Hacer el Pull Request en el git de Decentralized Climate de la rama develop personal a la rama develop del Repositorio de DCF.
## CONTACTO Y DESARROLLADORES
> Work developed in collaboration with the [Decentralized Climate Foundation](https://decentralizedclimate.org).
- [David E. Perez Negron R.](mailto:david@neetsec.com)
- [Gustavo Bermudez](mailto:nizaries44@gmail.com)
## Referencias
Cheatsheet de git flow: https://danielkummer.github.io/git-flow-cheatsheet/
Video Sobre gitflow: https://www.youtube.com/watch?v=BYrt6luynCI
Link Hackmd a Git: https://hackmd.io/c/tutorials/%2Fs%2Flink-with-github
Manual de markdown: https://hackmd.io/c/tutorials/%2Fs%2Fhow-to-create-book.
Cheatsheet de vim: https://devhints.io/vim

View File

@ -0,0 +1,70 @@
---
title: Taller de WEB3 static
author: Decentralized Climate Foundation
date: 2023-02-24
category: socialservice
layout: post
---
El proposito del siguiente taller es descentralizar una pagina estatica con varias herramientas y servicios gratuitos.
* Se debe documentar el proceso en un reporte markdown (cheetsheet).
* Si la fundacion tiene el manual y/o cheetsheet referente al titulo se debe contribuir a su al de la fundacion, si no agregar la documentacion en el repositorio docs.
* Agrega issues al repositorio official si encontraste o propones mejoras.
## Requerimientos
* Tener completado el taller de Git y GitFlow.
* Conceptos Basicos sobre IPFS.
* Acceso a cuenta fleek.co o crear una.
## Proceso
El estudiante deberá copiar la lista de cada subtema a una tarjeta en [nextcloud de servicios sociales](https://nextcloud.neetsec.com/index.php/apps/deck/#/board/10) en la descripcion como markdown, Se tiene que realizar las tareas del checklist y el encargado del estudiante de servicio social verificara y marcará como terminado cada tarea cuando el estudiante haga solicitud de revision.
### Jekyll
* Hacer un pomodoro para investigar que es y como funcionan Jamstack y Jekyll.
* Hacer un fork del [projecto docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs) y clonar en tu maquina.
* Crear un feature en tu repo clonado en tu maquina.
* Iniciar un projecto jekyll siguiendo [el tutorial](https://jekyllrb.com/docs/) [2] y si tienes linux, antes de seguir el tutorial, debe [configurarlo en linux](https://jekyllrb.com/docs/installation/ubuntu/) [6]
> Nota: si tienes zsh, en linux, cambiar ~/.bashrc por ~/.zshrc en los comandos de configuracion [6]
* Instalar a tu feature el tema [gitdocs](https://github.com/sighingnow/jekyll-gitbook#how-to-get-started) [3]
* Mover los documentos previos [projecto docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs) a la la carpeta en posts y convertir en el formato jekyll posts con la sección que le corresponde.
* Crear un archivo [.gitignore](https://git-scm.com/docs/gitignore) con los archivos inecesarios y estaticos generados por jekyll.
* Hacer un README.md EN INGLES sobre los pasos y requerimientos para llegar a este punto a partir de que se inicio el projecto git. [Ejemplo1](https://gitlab.com/deca-currency/decasearch) , [Ejemplo2](https://gitlab.com/deca-currency/price-mechanism).
* Finalizar el feature
* Hacer un pull request a la rama develop del [projecto docs](https://git.decentralizedclimate.org/DecentralizedClimateFoundation/docs)
### FLEEK e IPFS
### Deployment
## CONTACTO Y DESARROLLADORES
> Work developed in collaboration with the [Decentralized Climate Foundation](https://decentralizedclimate.org).
- [David E. Perez Negron R.](mailto:david@neetsec.com)
## Referencias
\[1\] Gustavo Bermudez, "Git-flow cheatsheet", https://hackmd.io/@SocialServicesDCF/r1-M3Lnpj, 2023.
\[2\] jekyllrb.com, "Quickstart", https://jekyllrb.com/docs/, 2023.
\[3\] sighingnow, "jekyll-gitbook", https://github.com/sighingnow/jekyll-gitbook#how-to-get-started, 2023.
\[4\] Bleecker, "Interplanetary File System.", https://hackmd.io/0nyNLX4eRX-t1NvqoyIdMQ?view, 2023.
\[5\] git-scm.com, "Documentation Reference - gitignore", https://git-scm.com/docs/gitignore, 2023.
\[6\] jekyllrb.com, "Jekyll on Ubuntu", https://jekyllrb.com/docs/installation/ubuntu/, 2023.