{"id":14980710,"url":"https://github.com/ekspek/ist-thesis","last_synced_at":"2025-07-05T21:41:30.922Z","repository":{"id":119235071,"uuid":"159515123","full_name":"ekspek/ist-thesis","owner":"ekspek","description":"Classe LaTeX para teses de mestrado do Instituto Superior Técnico","archived":false,"fork":false,"pushed_at":"2020-09-22T08:36:48.000Z","size":4001,"stargazers_count":14,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T03:01:50.302Z","etag":null,"topics":["instituto-superior-tecnico","ist","latex-class","latex-template","thesis-latex-template","thesis-template"],"latest_commit_sha":null,"homepage":"","language":"TeX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lppl-1.3c","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ekspek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2018-11-28T14:32:04.000Z","updated_at":"2023-11-23T10:23:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"90e51b0a-7dd2-4926-a1b6-844e66f3ca62","html_url":"https://github.com/ekspek/ist-thesis","commit_stats":{"total_commits":78,"total_committers":5,"mean_commits":15.6,"dds":"0.10256410256410253","last_synced_commit":"b6448cf749dc103d297861c2c67d46d4d1eb490a"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/ekspek/ist-thesis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ekspek%2Fist-thesis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ekspek%2Fist-thesis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ekspek%2Fist-thesis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ekspek%2Fist-thesis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ekspek","download_url":"https://codeload.github.com/ekspek/ist-thesis/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ekspek%2Fist-thesis/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263812051,"owners_count":23515321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["instituto-superior-tecnico","ist","latex-class","latex-template","thesis-latex-template","thesis-template"],"created_at":"2024-09-24T14:02:17.768Z","updated_at":"2025-07-05T21:41:30.863Z","avatar_url":"https://github.com/ekspek.png","language":"TeX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Modelo LaTeX de Tese Não Oficial do Instituto Superior Técnico\n\n[Read this page in english.](README_EN.md)\n\nModelo de tese de mestrado em LaTeX não oficial para documentos escritos para o Instituto Superior Técnico. Este projeto tem como objetivo criar uma classe de LaTeX que define todas as restrições definidas pelo Instituto Superior Técnico por defeito quando incluída e implementa funções adicionais para definir pormenores do documento e permitir um certo nível de personalização dentro das restrições existentes.\n\n## Utilização\n\nPara compilar um documento em LaTeX com esta classe, só é necessário fazer download do ficheiro [`ist-thesis.cls`](https://github.com/ekspek/ist-thesis/releases/download/v1.1.0/ist-thesis.cls).\n1. Colocar o ficheiro `ist-thesis.cls` na mesma pasta que o documento `.tex` a compilar;\n2. Incluir a linha abaixo no início do ficheiro;\n```tex\n\\documentclass{ist-thesis}\n```\n   - Opções podem ser incluídas entre parênteses retos entre `\\documentclass` e `{ist-thesis}`, como no exemplo seguinte. As opções utilizáveis encontram-se na documentação.\n```tex\n\\documentclass[english]{ist-thesis}\n```\n3. Compilar o documento.\n\n### Compilação\n\nQualquer documento que utilize esta classe pode ser compilado da mesma maneira que a maior parte dos documentos LaTeX, sem configurações adicionais. Num serviço como o [Overleaf](https://www.overleaf.com/ \"Overleaf\"), basta fazer upload da classe e compilar. Para uma instalação local, basta correr o compilador através do editor de eleição ou através de `pdflatex main.tex` ou `xelatex main.tex` na linha de comandos, onde `main.tex` é o documento a ser compilado.\n\nNo entanto, é necessária caução quando o documento for compilado com bibliografia e glossário. Ajuda para estes tópicos específicos será incluída na documentação.\n\n### Logótipos\n\nOs logótipos oficiais do Instituto Superior Técnico estão incluídos neste repositório, mas também podem ser encontrados na [página oficial](https://tecnico.ulisboa.pt/pt/sobre-o-tecnico/institucional/logo-e-manual-de-identidade/). A utilização destes logótipos é obrigatória e a ausência dos ficheiros correspondentes retorna erro.\n\n![Imagem da capa da tese de exemplo](./cover.png)\n\n## Documentação\n\nA documentação que é disponibilizada inclui detalhes sobre o conteúdo da classe e como melhor fazer uso das funções incluídas. Pode ser consultada neste [link](doc/doc.pdf) ou na pasta [doc](doc/) deste repositório, onde se encontra acompanhada do código fonte.\n\nFoi também preparado um exemplo de uma tese com formato *lorem ipsum* para exemplificar algumas das funções da classe em si e também algumas (na minha opinião) boas práticas na escrita de documentos em LaTeX. Este encontra-se num [repositório separado](https://github.com/ekspek/ist-thesis-template) que acompanha este. Também irá aparecer na galeria do Overleaf quando a submissão for aprovada.\n\nPoderá também vir a ser incluído um documento de ajuda com a criação da tese, separado da documentação oficial, para auxiliar em diversos aspetos de LaTeX.\n\n## Erros, Problemas e Sugestões\n\nProblemas com utilização da classe podem ser reportados aqui mesmo no GitHub ou contactando-me a mim ou a outros contribuidores diretamente. Contribuições em qualquer aspeto do projeto são bem-vindas!\n\nOs erros, objetivos e outras discussões podem ser criadas e encontradas na página de [*Issues*](https://github.com/ekspek/ist-thesis/issues) do GitHub.\n\n### Estado Atual do Projeto\n\nO projeto neste momento encontra-se concluído e pronto a ser utilizado. Não implica, no entanto, que não possa ser atualizado ou alterado com o passar do tempo. Recomenda-se, portanto, que se atualize o ficheiro quando houver atualizações nesta página, ou pelo menos quando houver uma [*release*](https://github.com/ekspek/ist-thesis/releases) nova.\n\nO progresso pode também ser observado na página de [*Issues*](https://github.com/ekspek/ist-thesis/issues) do GitHub.\n\n#### Considerações sobre este projeto\n\nEste projeto não é o primeiro nem será o último modelo de tese em LaTeX feito pela comunidade do IST. Em comparação a outros modelos, no entanto, este tem o objetivo de ser simples de utilizar, não distribuíndo um modelo pronto para ser subtituído com texto do autor mas sim fornecendo uma base para tal, definindo as regras e restrições da Direcção Académica e permitindo ao utilizador definir o resto como preferir, tentando não interferir com a experiência típica de LaTeX e da classe `report`. É, portanto, um projeto mais indicado a utilizadores com alguma experiência em LaTeX e que se sintam confortáveis a criar um documento de raíz (ou copiando trabalhos anteriores).\n\nNo entanto, para quem precisar, criei [um exemplo de tese](https://github.com/ekspek/ist-thesis-template) para auxiliar com os aspetos que a classe de tese aqui distribuída não cobre. Também estou disponível para contactar com quem precisar de ajuda com LaTeX, dentro dos meus conhecimentos. Os contactos estão incluídos acima.\n\n## Referências\n\nOs regulamentos de elaboração da tese foram retirados do [Guia de Preparação da Dissertação](https://academica.tecnico.ulisboa.pt/files/sites/54/guia-de-preparacao-da-dissertacao-1516.pdf \"Guia de Preparação da Dissertação\") da Direção Académica do Instituto Superior Técnico.\n\nInspiração e referência também foram retiradas do excelente [conjunto de documentos para elaboração da tese](https://fenix.tecnico.ulisboa.pt/homepage/ist31052/documentos-para-elaboracao-da-tese), criados e distribuídos pelo Professor André Marta do Instituto Superior Técnico.\n\n## Licença\n\nEste projeto está licenciado através da [LaTeX Project Public License](https://www.latex-project.org/lppl/), versão 1.3c.\n\nQuaisquer dados pertinentes ao Instituto Superior Técnico em si (em especial os logótipos) são propriedade do Instituto Superior Técnico e da Universidade de Lisboa.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekspek%2Fist-thesis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fekspek%2Fist-thesis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fekspek%2Fist-thesis/lists"}