# Obsidian

Instrucciones para configurar `Obsidian` con un repositorio `Git`

## Requisitos

- [Obsidian](https://obsidian.md/)
- [Git](https://git-scm.com/)
- Un repositorio `git` previamente clonado

## Configuración

### Git

#### Personal Access Token

> **NOTA:** Solo es necesario para repositorios que usen conexión por `HTTP` o `HTTPS`.

En `GitLab`, crear un `Personal Access Token` para poder realizar tareas en el repositorio sin necesidad de ingresar el usuario y la contraseña. Vaya a las opciones de su perfil, de clic en `Settings` -> `Access Tokens` y genere un nuevo token con los siguientes parámetros:

- **Name:** Obsidian
- **Expires at:** (Seleccionar una fecha de expiración no mayor a un año)
- **Scopes:**
    - [x] api

En el repositorio, abrir el archivo `.git/config` y modificar la url remota para tener el nombre de usuario, un símbolo de dos puntos (`:`), el token previamente creado y un símbolo arroba (`@`) antes de la IP o la url. Un ejemplo puede ser:

`https://USUARIO:AGREGAR_TOKEN_AQUI@github.com/usuario-ejemplo/repo-ejemplo.git`

#### Configurar Obsidian

Abrir `Obsidian`, dar clic en el botón `Open folder as vault` y seleccionar la carpeta del repositorio. En el panel izquierdo, en la parte inferior a la derecha dar clic en el ícono de `engranaje`.

Ir a la sección `Community plugins`, dar clic en `Turn on community plugins` -> `Browse`, buscar `Git` e instalar el plugin `Git` del usuario *Vincent*.

Dar clic en `Enable`. 

Con esto, ya se puede usar `Obsidian` con `Git`.