{"id":14577926,"url":"https://github.com/dpmj/alcazar","last_synced_at":"2026-07-18T17:12:24.627Z","repository":{"id":165714382,"uuid":"640624274","full_name":"dpmj/alcazar","owner":"dpmj","description":"A free and Open-Source LaTeX template for academic works: theses, reports, etc.","archived":false,"fork":false,"pushed_at":"2025-08-15T12:41:54.000Z","size":22213,"stargazers_count":28,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-04T12:49:28.283Z","etag":null,"topics":["latex","latex-book","latex-report","latex-template","latex-theme","latex-thesis","pdflatex","report","thesis","thesis-latex-template","thesis-template","thesis-template-latex"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dpmj.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-05-14T17:45:57.000Z","updated_at":"2025-09-01T10:40:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"1eab22a3-171d-4e0b-be49-59aa24bf2e6a","html_url":"https://github.com/dpmj/alcazar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dpmj/alcazar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpmj%2Falcazar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpmj%2Falcazar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpmj%2Falcazar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpmj%2Falcazar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dpmj","download_url":"https://codeload.github.com/dpmj/alcazar/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dpmj%2Falcazar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35624656,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-18T02:00:07.223Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["latex","latex-book","latex-report","latex-template","latex-theme","latex-thesis","pdflatex","report","thesis","thesis-latex-template","thesis-template","thesis-template-latex"],"created_at":"2024-09-07T17:01:22.983Z","updated_at":"2026-07-18T17:12:24.611Z","avatar_url":"https://github.com/dpmj.png","language":"TeX","funding_links":["https://ko-fi.com/dpmjuan'"],"categories":["Popular \u0026 New LaTeX Templates"],"sub_categories":["Others"],"readme":"\u003cp align=\"center\"\u003e\n\u003cimg src=\"figures/examples/alcazar-title.png\" width=\"100%\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cb\u003e\n\u003ca href=\"https://raw.githubusercontent.com/dpmj/alcazar/main/main.pdf\"\u003eSee PDF Preview\u003c/a\u003e\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href='https://ko-fi.com/dpmjuan' target='_blank'\u003e\u003cimg height='42' style='border:0px;height:42px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Philosophy\n\n- KISS.\n- Easy to use.\n- Organized, elegant, coherent and consistent.\n- Compact, but not crowded.\n- Compatible with `latexmk` and `pdflatex`\n- No exotic or discontinued packages.\n\n## Features\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"figures/examples/alcazar-feature-display.png\" width=\"100%\"/\u003e\n\u003c/p\u003e\n\n- A page to include information about the authors.\n- A page to include a license.\n- Automatic generation of a bibtex cite.\n- *\"Executive overview\"* page (sometimes required in University Degrees adhered to ABET).\n- A page to cite your own papers as a result of the project.\n- An acknowledgements page and a dedication page. \n- Automatic Table of Contents (ToC), List of Figures (LoF) and List of Tables (LoT).\n- Two-column bibliography and glossary.\n- Support for appendices. \n- Templates for the Sustainable Development Goals (SDGs) are included in Appendix C if required.\n\n## Customisation\n\n- Details about you and your work are defined in `main.tex'. Fill it in according to your thesis. The document will automatically update all occurrences, including a copy-and-paste-ready bibtex citation! \n- The title page can be easily configured by editing `opening/titlepage.tex`. Include here your faculty's logos.\n- Fill in information about the authors in `opening/about.tex`. You can include here a photography of the authors.\n- Edit `opening/acknowledgements.tex` and `opening/dedication.tex` as you like!\n- Include your abstract (in one or more languages) in `opening/abstract.tex`.\n- Chapter and appendix numbers on the page margins can be problematic for printing. They can be disabled by commenting/uncommenting a few lines of code in `style/alcazar.sty`, under the `\\fancypagestyle{chapters}` and `\\fancypagestyle{addenda}` styles.\n\n### Fonts\n\nThe default font is *[Libertinus Serif](https://tug.org/FontCatalogue/libertinusserif/)* plus *[Libertinus Sans](https://tug.org/FontCatalogue/libertinussans/)*.\n\nYou can change this in `style/pkgs.sty`. Other high quality options I recommend are *[Source Serif Pro](https://tug.org/FontCatalogue/sourceserifproregular/)* plus *[Source Sans Pro](https://tug.org/FontCatalogue/sourcesanspro/)*. \nThe template handles well a Sans-Serif font as base font of the whole document, with *Source Sans Pro* and *[Inter](https://tug.org/FontCatalogue/interregular/)* being two good options. \n\nThe default monospace font is *[IBM Plex Mono]()*. Equally good alternatives are *[Fira Mono]()* and *[Inconsolata](https://tug.org/FontCatalogue/inconsolata/)*.\n\nAll these options appear as commented lines in `style/pkgs.sty`, with the correct font scale and options already prepared.\n\n## Build\n\n### Using Overleaf\n\nDownload this repo as a `.zip` file, then upload the file to Overleaf as a new project. It should work out of the box.\n\n### Manually\n\n#### Important information\n\nThis project can be built with `latexmk` or `pdflatex`, although **I greatly encourage the use of `latexmk`.** Below are examples of compilation commands with some recommended arguments. The `-shell-escape` flag is required for the `minted` package. With `latexmk` both `biber` and `makeglossaries` should run automatically.\n\nA `Makefile` is already included, which invokes `latexmk`. To compile, simply run `make` in the project's root directory. Run `make clean` to remove all auxiliary files. \n\nRequirements:\n \n- `biber` for `biblatex`, \n- `python 3` and `pygments` for the `minted` package.\n\nThis template has been confirmed as working on both Linux (TeX Live) and Windows (MiKTeX).\n\n#### With `latexmk`\n\nThis project does not need a `latexmkrc` file.\n\n```bash\nlatexmk -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error -pdf main    \n```\n\n#### With `pdflatex`\n\nRun:\n```bash\npdflatex -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error main\nbiber main\nmakeglossaries main\npdflatex -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error main\npdflatex -shell-escape -synctex=1 -interaction=nonstopmode -file-line-error main\n```\nSometimes an additional call to `pdflatex` may be necessary.\n\n\n### Using the LaTeX Workshop extension for Visual Studio Code / Codium by James Yu \n\n**Recipes and tools for the `latexmk` and `pdflatex` recipes are already provided in `.vscode/settings.json`. Alcázar should compile out of the box with the default `latexmk` recipe.** \n\nManual configuration is described below, if needed:\n\n#### `latexmk` recipe\n\nWorks with the default `latexmk` recipe out of the box. These settings are recommeded:\n\n```json\n\"latex-workshop.latex.autoBuild.run\": \"never\",\n\"latex-workshop.intellisense.citation.backend\": \"biblatex\",\n\"latex-workshop.latex.outDir\": \"%DIR%\",\n```\n\n#### Creating a new `pdflatex` recipe\n\nTo compile using `biber` and `makeglossaries` with `pdflatex` you need to add the following tools to your `.vscode/settings.json` configuration file, under the section `latex-workshop.latex.tools` (In the UI, navigate to *Latex-workshop \u003e Latex: Recipes \u003e Edit in settings.json*): \n```json\n{\n    \"name\": \"biber\",\n    \"command\": \"biber\",\n    \"args\": [\n        \"%DOC%\"\n    ],\n},\n{\n    \"name\": \"makeglossaries\",\n    \"command\": \"makeglossaries\",\n    \"args\": [\n        \"%DOCFILE%\"\n    ],\n}\n```\nEdit the `pdflatex` entry as follows to include the `-shell-escape` argument:\n```json\n{\n    \"name\": \"pdflatex\",\n    \"command\": \"pdflatex\",\n    \"args\": [\n        \"-shell-escape\",\n        \"-synctex=1\",\n        \"-interaction=nonstopmode\",\n        \"-file-line-error\",\n        \"%DOC%\"\n    ],\n    \"env\": {}\n}\n```\nNow add a new recipe, under `latex-workshop.latex.recipes` (to generate the configuration section from the UI, go to *Latex-workshop \u003e Latex: Tools \u003e Edit in settings.json*):\n```json\n{\n    \"name\": \"alcazar\",\n    \"tools\": [\n        \"pdflatex\",\n        \"makeglossaries\",\n        \"biber\",\n        \"pdflatex\",\n        \"pdflatex\"\n    ]\n}\n```\nAnd run the `alcazar` recipe. \n\n**Note:** If you keep getting a `makeglossaries` error saying that `main.aux` could not be found, set the `latex-workshop.latex.autoBuild.cleanAndRetry.enabled` setting to `false` (in the UI, uncheck *\"Latex-workshop \u003e Latex \u003e AutoBuild \u003e Clean and retry: Enabled\"*)\n\n## Template file structure\n\nThe file structure of Alcázar is simple and self-explanatory:\n```\n./\n├── bibliography/               # BIBLIOGRAPHY\n|   ├── bibliography.tex        # Bibliography generation\n|   └── references.bib          # BibTeX references\n|\n├── figures/                    # Put your figures here\n|\n├── glossary/                   # GLOSSARY\n|   ├── glossary.sty            # Glossary definitions\n|   └── glossary.tex            # Glossary generation\n|\n├── opening/                    # OPENING\n|   ├── resources/              # Graphics used in the opening (logos, etc)\n|   |\n|   ├── about.tex               # Details about the authors\n|   ├── abstract.tex            # Abstract, in various languages\n|   ├── acknowledgements.tex    # Acknowledgements\n|   ├── dedication.tex          # Dedication\n|   ├── opening.tex             # Structures the opening part of the document\n|   └── publications.tex        # Your publications. Optional, comment line in opening.tex\n|   └── titlepage.tex           # Title page\n|\n├── style/                      # STYLE\n|   ├── alcazar.sty             # Style definition and configuration\n|   ├── colors.sty              # Colors definition\n|   └── pkgs.sty                # Only used to import packages\n|\n├── text/                       # TEXT\n|   ├── appendix/               # Put your addendum here\n|   |   ├── appendix.tex        # Appendix generation\n|   |   └── thanks.tex          # Say thanks. Optional, comment line in main.tex\n|   |\n|   └── chapters/               # Put your chapters here\n|\n└── main.tex                    # The main document.\n```\n\n## Thanks!\n\nAlcázar was born as a personal project to replace the poor quality report templates I encountered throughout my academic life. It continued to grow until it made sense to create a comprehensive template. I have learned a lot during the development of Alcázar.\n\nThanks to my friends and colleagues who beta-tested Alcázar. You found many bugs, made excellent suggestions and inspired me a lot.\n\nAnd to all the people who have already used Alcázar, I hope I have helped you despite my questionable LaTeX skills!\n\nIf you enjoy Alcázar, you can buy me a coffee on Ko-Fi! :)\n\n\u003ca href='https://ko-fi.com/dpmjuan' target='_blank'\u003e\u003cimg height='42' style='border:0px;height:42px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n\n## Credits / citation\n\nIf you use and like this template, please consider giving credit :) This is completely optional, of course ;)\n\nThere is already a small acknowledgement text in `opening/license.tex` below the document license. \n\n```bibtex\n@misc{alcazar-latex-template,\n  author = {Del Pino Mena, Juan},\n  title = {Alcazar: A free and Open-Source LaTeX template for academic works},\n  url = {https://github.com/dpmj/alcazar},\n  doi = {10.5281/zenodo.13935260}\n}\n```\n\n## License\n    \nThis work is licensed under a\n[Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-nc-sa/4.0/).\n\nThis licence only applies to derivatives of the template itself. You can licence your reports created using this template however you wish, although I would encourage you to use a Creative Commons licence.\n\n## Disclaimer\n\nThis work is not affiliated with any institution, and the references, logos, and the like are merely examples of usage. All third-party resources included in this repository are the property of their respective owners and are provided for convenience only.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpmj%2Falcazar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdpmj%2Falcazar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdpmj%2Falcazar/lists"}