Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/l-51/plantilla-de-latex-para-visual-studio-code-vscode

Tutorial junto con una plantilla para usar y configurar LaTex en visual studio code (VSC)
https://github.com/l-51/plantilla-de-latex-para-visual-studio-code-vscode

latex latex-template plantilla student-tools student-vscode template tex visual-studio-code

Last synced: 11 months ago
JSON representation

Tutorial junto con una plantilla para usar y configurar LaTex en visual studio code (VSC)

Awesome Lists containing this project

README 

          
# Plantilla de organización de LaTeX en Visual Studio Code (Linux)

## Tutorial: Configuración paso a paso

Plantilla de LaTeX lista para usar en **Visual Studio Code (VSC)** en Linux.



Incluye configuración básica, instalación de extensiones, compilación automática y organización de proyecto en carpetas.



Ideal para estudiantes y profesionales que quieran escribir documentos en LaTeX desde VS Code de forma rápida y ordenada.



## Tabla de contenido

- [Configuración básica](#configuración-básica)

- [Tips (Consejos)](#tipsconsejos)

- [Conectar con el repositorio Git](#conectar-con-el-repositorio-git)

- [Organización del proyecto](#organización-del-proyecto-hay-texto-de-ejemplo-en-los-ficheros)

- [Recomendación final](#️recomendación-final)

- [Recursos adicionales](#recursos-adicionales)



## Configuración básica

- **Instalar Visual Studio Code** 


  Accede a [Instalar VSC para Linux](https://code.visualstudio.com/docs/setup/linux) y seguir los pasos

  

- **Instalar extensiones en VSC** 


  `Ctrl + Shift + X` Accedes a extensiones y seleccionas **LaTex Workshop** de James Yu:

  


    Extension

    
Incono de extensión


  

  


    LaTex Workshop

    
Resultado de la búsqueda LaTex Workshop


  



- **Instalar paquetes en Linux** 


  Al no usar un compilador online tenemos que instalar los paquetes necesarios de manera local por nuestra cuenta realizando `sudo apt install texlive-full -y` para los paquetes de LaTex, se puede usar el atajo `Ctrl + '` para abrir el terminal o desde el icono interactivo:

  


    Terminal

    
Visualizar terminal de manera interactiva


  

  



## Tips(Consejos)

- Al tener cuenta de estudiante, el **Copilot de Github** se puede usar gratuitamente.

  

  En caso de querer usarlo, instalar **Github Copilot** y **Github Copilot Chat** en el apartado de extensiones como previamente se indicó.

  

  Para conectar con su cuenta de estudiante, sería ir al apartado de su perfil -> `setting` -> `Emails` y añadir tu cuenta de estudiante

  

- `Ctrl + S` para guardar/compilar:

  


    Guardar/Compilar

    
Guardar de manera interactiva


  



- `Ctrl + Alt + V` para visualizar:

  


    Visualizar

    
Icono para visualizar


  



- Si tienes el `main.pdf` abierto para visualizar como previa mención, al guardar, se puedes ver los cambios reflejados en el pdf

  

- `Ctrl + Alt + X` le abrirá una ventana asociado al compilador de Latex y abajo izquierda con snippet

  


    Snippet

    
Localización de las facilidades de LaTeX


  



- `Ctrl + I` para abrir **Copilot**(en caso de disposición de su extensión)

  


    Inline chat

    
Iniciar una interacción con el chatbot


  



- **(Comodidad visual)** Para una mejor visualización del entorno, abrimos configuración o en su defecto `Ctrl + ,`, escribir en la barra de búsqueda **rulers**, para posteriormente abrir **Edit in setting.json**, tras `"workbench.colorTheme": "Default Light Modern",` añadimos lo siguiente para que aparezca a la anchura de 80 caracteres un delimitador cual ajusta la anchura de texto de forma automática:

  

    "editor.rulers": [80],

    "editor.wordWrap": "wordWrapColumn",

    "editor.wordWrapColumn": 80,

  


     

  


    Configuración

    
Localización de configuración de manera interactiva


  

  


    Rulers 

    
Resultado de búsqueda de "rulers"


  

  


    settings.json

    
settings.json tras introducir las reglas


  



- **(Opcional 1)** Para configurar la localización de los archivos de salida de compilación, pulse `Ctrl + ,` para abrir configuración y busque `Latex: Out Dir`, cambie la salida por una carpeta o una ruta donde quieras preservar los archivos. Una vez compilado el proyecto la salida se verá reflejado en dicha ruta(se usó [./build](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/build) de ejemplo). Para esta parte es recomendable que se use un fichero [`.gitignore`](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/blob/main/template/.gitignore) para que no se guarde archivos que no le interese en el repositorio. En comparación a **Opcional 2** como se indica abajo, hay una carpeta de más, pero a la hora de compilación es más **rápido** ya que mantiene los archivos de compilación, aunque ocupe más espacio

  


    Out dir

    
Ejemplo de establecer la salida en ./build


  

  

- **(Opcional 2)** Si accedes a ajuste sea por icono o sea por `Ctrl + ,`, y busca `LaTex Auto Build Run` le aparecerá un apartado donde se podrá elegir la opción de compilación:

  - `never` compila solo cuando lanza el comando **Build LaTeX project** manualmente (`Ctrl+Alt+B` por defecto)

  - `onSave` compila solo cuando **guardas el archivo** (`Ctrl+S`), más recomendable para tener un mejor control de la compilación

  - `onFileChange` compila automáticamente cada vez que **detecta un cambio en el archivo** (aunque no lo guardes)

    

  Y al buscar `LaTex Auto Clean Run`, también dispone de opciones:

  - `onBuilt` limpia después de **cada compilación**

  - `onFailed` limpia solo si la **compilación falla**

  - `onSucceeded` limpia solo si **compilación fue exitosa**

  - `never` limpia solo cuando lanza el comando **LaTeX Workshop: Clean up auxiliary files** (lo puedes buscar con `Ctrl+Shift+P`)



  AutoBuild Run

  
Resultado de la búsqueda





  AutoBuild Run

  
Resultado de la búsqueda





  AutoBuild Run

  
settings.json tras elegir el modo



  Además para poder eliminar todos los archivos de compilación manteniendo solo el `main.pdf`, habría que añadir parámetros en ajuste buscando `Clean: File Types` y en `Clean: Method` elegir la opción **glob** o en su efecto añadiendo al archivo `settings.json` buscando **rulers** como previo en **comodidad visual** del apartado [tips](#tipsconsejos) se indica, y añadir al final de ella:

  

    "latex-workshop.latex.autoBuild.run": "onSave",

    "latex-workshop.latex.autoClean.run": "onBuilt",

    "latex-workshop.latex.clean.fileTypes": [

        "*.aux",

        "*.bbl",

        "*.bcf",

        "*.blg",

        "*.idx",

        "*.ilg",

        "*.ind",

        "*.lof",

        "*.lot",

        "*.out",

        "*.toc",

        "*.acn",

        "*.acr",

        "*.alg",

        "*.glg",

        "*.glo",

        "*.gls",

        "*.fls",

        "*.log",

        "*.fdb_latexmk",

        "*.snm",

        "*.synctex(busy)",

        "*.synctex.gz(busy)",

        "*.nav",

        "*.vrb",

        "*.run.xml",

        "*.synctex.gz"

    ],

    "latex-workshop.latex.clean.method": "glob",

  


  
Con opción de onSave y onBuilt, eliminando todos los archivos de compilación


  


    CleanFileTypes

    
Resultado de búsqueda y añadir parámetros de forma interactiva


  

  


    CleanMethod

    
Elegir el método de limpieza de forma interactiva


  



## Conectar con el repositorio Git

1. Instalación de **Git**: si no lo tenían previamente instalado, `sudo apt install git -y`

2. Configurar tu usuario y correo:


   `git config --global user.name "Tu Nombre"` 


   `git config --global user.email "tuemail@dominio.com"`

4. Accede a la carpeta donde quieras tener este proyecto guardado y clónalo escribiendo en la terminal de VSC y poner: 


   `git clone https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE` 


   O en su defecto descargarse el fichero zip [descargar](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/releases/tag/v1.0.0)

6. Abre la carpeta usando **Open Folder** de VSC o la carpeta que te interesa para realizar _click derecho_ -> _abrir con_ -> escribir **code** -> _Enter_

7. Para guardar los cambios en **Git** o para sincronizar con el repositorio vayase al apartado de **Source Control** o mediante atajo `Ctrl + Shift + G`, donde podrá realizar un **commit**, para recibir cambios del repositorio **pull**, o modificar el respositorio mediante **push**, en su defecto, a la hora de hacer **commit**, se puede desplegar a la derecha y emplear **Commit & Push** o **Commit & Pull**.



  Source Control





  Pull





  Push





  Commit &




## Organización del proyecto (Hay texto de ejemplo en los ficheros)

- [**bibliografia**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/bibliografia) Aquí guardará las referencias en el fichero [ref.bib](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/blob/main/template/bibliografia/ref.bib)

- [**config**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/config) Aquí están los [paquetes](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/config/packages.tex) que usarás y [comandos](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/config/command.tex) que se aplica de forma general al proyecto

- [**secciones**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/secciones) Esta carpeta contendrá las distintas secciones que forman parte del trabajo

- [**images**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/tree/main/template/images) Carpeta de las imágenes que se usarán para el proyecto

- [**portada.tex**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/blob/main/template/portada.tex) Este archivo contiene la portada del trabajo en formato LaTeX

- [**main.tex**](https://github.com/L-51/Plantilla-de-LaTex-para-Visual-Studio-Code-VSCODE/blob/main/template/main.tex) El main donde se incluirá todo, se indica al principio de esta `% !TeX root = main.tex

`



---  

## ⚠️Recomendación final:

Si tienes poco manejo a la hora de usar GitHub para trabajar con varios usuarios y una mayor comodidad, se recomienda separar de forma explícita los ficheros donde trabajarán cada uno de ellos, y evitar en la medida de lo posible modificar ficheros no correspondido de forma accidental



---

## Recursos adicionales:

- [Documentación de LaTeX Workshop](https://github.com/James-Yu/LaTeX-Workshop)

- [Manual sencillo de LaTex](https://manualdelatex.com/tutoriales)

- [Plantillas realizadas por LosDelGIIM](https://github.com/LosDelDGIIM/LosDelDGIIM.github.io/tree/main/subjects/_plantillas)