add some readme, change log folder name to pdf
This commit is contained in:
25
README.md
25
README.md
@@ -1,3 +1,26 @@
|
||||
# AutoLTX
|
||||
|
||||
Automated build system for compiling Latex Files, mimicing the Overleaf build system.
|
||||
Automated build system for compiling Latex Files, mimicing the Overleaf build system.
|
||||
|
||||
1. Build the docker container using:
|
||||
```bash
|
||||
docker build -t autoltx:latest .
|
||||
```
|
||||
|
||||
2. Download the overleaf project as a zip file or using the git integration to easily push any changes.
|
||||
|
||||
3. Use the following command to attach the project folder to the built container.
|
||||
|
||||
```bash
|
||||
docker run --rm -it -e "mainFile=<mainTEXfile>" -v <projectFolderPath>:/app/project:z --user 1000:1000 autoltx:latest
|
||||
```
|
||||
|
||||
replace `<mainTEXfile>` with the primary tex file to compile, `<projectFolderPath>` with the path to the project folder.
|
||||
|
||||
This will compile your project whenever a change is observed in the `mainTEXfile` file.
|
||||
|
||||
### Observables:
|
||||
|
||||
- The container will create a new folder `pdf` which contains all the build files.
|
||||
- Once the project compiles, the result is put into the `<projectFolderPath>`, called `output.pdf`. Keep it open so any changes to the main tex file, triggers a pdf update. Other files include `compile.sh`: the main compilation script, `latexmkrc`: used by the `latexmk` compiler, edit cautiously, and `.autoltx`: used for versioning the container scripts.
|
||||
- These files are added to gitignore if present to avoid tracking unnecessary files by git.
|
||||
|
||||
Reference in New Issue
Block a user