From c0d485811949e7368de92e18c8f9aec41d48bbe1 Mon Sep 17 00:00:00 2001 From: Thomas Kuschel Date: Wed, 20 Nov 2024 10:55:52 +0100 Subject: [PATCH] Update README.md --- README.md | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/README.md b/README.md index 98706eb..c5b404a 100644 --- a/README.md +++ b/README.md @@ -14,3 +14,48 @@ We show here the possibility of changing the names of the months to the Austrian The repository uses git's lfs, large file system, to store pdf files. If you want to work on the project and commit with git, you must first install **git-lfs**. Afterwards, you can clone this repository. + +## Installation of Latex -- Editor -- and Code (Visual Studio) +### My recommandation + +1. Install TeX Live from https://tug.org/texlive/ + + For Windows PCs, the installer file **install-tl-windows.exe** will install all necessary files to the hard disk (C:/texlive/2024) to manage the active versions of each TeX package via a **tlshell**, a TeX Live Shell where you can update/install any latex package. + + If you are new to LaTex, just install all packages to your system. It took several minutes (hours) to install all the TeX libraries. + +2. Install Code, i.e. Visual Studio Code from https://code.visualstudio.com/ + +3. Install Git and Git-LFS from https://git-scm.com/ and https://git-lfs.com/ + + This is my recommanded versioning system for my tex code. + Additionally, I use the file .gitignore in my repository to ignore several files in its folder which can be found at + https://github.com/github/gitignore , especially the file https://github.com/github/gitignore/blob/main/TeX.gitignore + + Copy this file as .gitignore to the root folder of your repository. + + In addition, I use a **.gitattributes** file to manage large files inside git (git-lfs): +``` +*.zip filter=lfs diff=lfs merge=lfs -text +*.gz filter=lfs diff=lfs merge=lfs -text +*.image filter=lfs diff=lfs merge=lfs -text +*.pdf filter=lfs diff=lfs merge=lfs -text +*.jpg filter=lfs diff=lfs merge=lfs -text +*.png filter=lfs diff=lfs merge=lfs -text +*.gif filter=lfs diff=lfs merge=lfs -text +*.ai filter=lfs diff=lfs merge=lfs -text +*.psd filter=lfs diff=lfs merge=lfs -text +*.doc* filter=lfs diff=lfs merge=lfs -text +*.xls* filter=lfs diff=lfs merge=lfs -text +*.ppt filter=lfs diff=lfs merge=lfs -text +*.ppt* filter=lfs diff=lfs merge=lfs -text +*.emf filter=lfs diff=lfs merge=lfs -text +*.wmf filter=lfs diff=lfs merge=lfs -text +*.raw filter=lfs diff=lfs merge=lfs -text +*.exe filter=lfs diff=lfs merge=lfs -text +*.SchDoc filter=lfs diff=lfs merge=lfs -text +``` + +4. Install the Extension **LaTeX Workshop** inside (Visual Studio) Code + +--