e76ac00ad6
* Initial plan * Add comprehensive thesis completion game plan (deadline Feb 10) Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Add quick start guide and daily progress tracking template Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Add visual tracker and planning system overview Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Update work schedule to 4hrs weekdays, 8hrs weekends (144 total hrs) Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Update dates to Jan 16-Feb 15, add helper scripts for data collection Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Add complete LaTeX content for chapters 5-8, graph generation script, auto-compile script Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Add extensive citations throughout chapters, fix Linux-specific issues, replace subjective language with objective data Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Fix CI pipeline: use test_pdf instead of test target in workflow Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> * Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: kuhyx <147418882+kuhyx@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| src | ||
| test | ||
| tex | ||
| bibliografia.bib | ||
| fix-polish-fonts.py | ||
| fix-polish-fonts.sh | ||
| LICENSE | ||
| main.app | ||
| main.bbl-SAVE-ERROR | ||
| main.pdf | ||
| main.tex | ||
| README.md | ||
| requirements.txt | ||
| SConstruct | ||
WUT-Thesis 
Repozytorium zawiera szablon pracy dyplomowej w LateXu: inżynierskiej oraz magisterskiej - przeznaczony dla Wydziału EiTI oraz Wydziału MEiL Politechniki Warszawskiej.
Linki:
Sposób użycia
Szablon jest dostępny na platformie webowej Overleaf, co umożliwia korzystanie z niego bez konieczności instalacji TeXa na własnej maszynie. Jest to najprostsza i rekomendowana metoda korzystania z szablonu.
Czasami Zazwyczaj może się zdarzyć jest tak, że wersja dostępna na Overleafie jest nieco sporo starsza niż ta znajdująca się na GitHubie. Wynika to z procesu aktualizacji tj. ręcznego zatwierdzania każdej zmiany przez administratorów Overleafa. Jeżeli chcesz korzystać z najnowszej wersji szablonu, możesz pobrać kod z repozytorium i zainstalować TeXa we własnym zakresie. Szczegółowe wskazówki i instrukcje znajdują się w zakładce Kompilacja oraz na Wiki.
Wydziały oraz języki
Szablon przeznaczony jest dla wydziału EiTI oraz MEiL Politechniki Warszawskiej, a prace dyplomowe można pisać w języku polskim lub angielskim. Wyboru wydziału oraz języka dokonujemy w pliku main.tex. Wybór wydziału (a tym samym wygląd strony tytułowej) określamy komendą
\facultyeiti
lub
\facultymeil
natomiast język wybieramy za pomocą komendy
\langpol
lub
\langeng
Status szablonu
Szablon jest zgodny z aktualnymi wymogami edytorskimi dla prac dyplomowych, określonych w Zarzadzeniu nr. 4/2022 Rektora PW i zawiera wszystkie wymagane elementy: stronę tytułową, streszczenia, deklarację o autorstwie.
Poniższa tabela podsumowuje status zgodności szablonu z w/w Zarządzeniem. Wiersze pogrubione oznaczają elementy formatowania, które wg. Zarządzenia są "wymagane" lub "do wyboru" (spośród kilku opcji), pozostałe elementy formatowania są określone jako "zalecane".
| Element formatowania | Status |
|---|---|
| Druk dwustronny, A4 | Jest |
| Margines wewnętrzny | 30 mm |
| Margines zewnętrzny | 25 mm |
| Margines górny i dolny | 25 mm |
| Krój pisma | Adobe Utopia, 12 pt |
| Interlinia | 1,15 |
| Numeracja stron | U dołu z odbiciem lustrzanym |
| Styl akapitu | Wcięcie 0,5 cm |
| Odwołania do źródeł | Styl numeracyjny |
| Numeracja tabel i rysunków | Kolejna w rozdziałach |
| Bibliografia | Styl numeracyjny |
| Tytuł tabeli | Nad tabelą, wyśrodkowany, 9 pt |
| Podpis rysunku | Pod rysunkiem, wyśrodkowany, 9 pt |
| Podrozdziały | Do 3 poziomów |
| Wyliczenia | Dostępne: wyliczenia numerowane, kropka lub myślnik |
| Przypis dolny | Numeracja ciągła, czcionka 9 pt |
W dokumencie zawarte są przykładowe fragmenty kodu:
- bibliografia, zawierająca różne typy źródeł: artykuł, książka lub jej fragment, raport, specyfikacja techniczna, repozytorium kodu;
- fragment kodu źródłowego programu;
- wykaz symboli i skrótów, spis rysunków, tabel oraz załączników;
i wiele innych.
Szablon został zatwierdzony przez niektóre Instytuty wydziału EiTI do oficjalnego użytku. W trakcie realizacji są ustalenia z pozostałymi instytutami oraz podniesienie szablonu do rangi ogólnowydziałowego.
Kompilacja
Aby skompilować szablon na własnej maszynie, konieczna jest instalacja LaTeXa:
Następnie należy wyposażyć się w IDE/edytor. Szablon jest rozwijany z użyciem VS Code, wyposażonym we wtyczkę LaTeX Workshop. Możliwa jest również kompilacja z linii poleceń za pomocą SCons (wymagany Python).
Aby zbudować plik PDF z pracą dyplomową, wystarczy z linii poleceń w głównym folderze projektu wykonać:
scons quick
Plik PDF z pracą dyplomową pojawi się w głównym folderze projektu.
Szczegółowe informacje nt. samodzielnej kompilacji szablonu i rozwiązania ew. problemów znajdują w encyklopedii projektu.
Problemy
Preferowanym kanałem zgłaszania problemów z szablonem są issues-y na GitHubie. Pisz tam, jeżeli masz jakiś problem.
Dla deweloperów
Informacje dla osób zainteresowanych rozwijaniem szablonu znajdują się w encyklopedii projektu.
CI/CD i Branch Protection
Repozytorium posiada automatyczne testy CI sprawdzające poprawność kompilacji dla wszystkich kombinacji wydziałów, języków i typów prac. Aby zapewnić jakość kodu:
- Branch Protection: Zobacz ../.github/BRANCH_PROTECTION.md dla instrukcji konfiguracji wymaganych testów przed mergowaniem do
main/master - Pre-commit hooks: Zainstaluj lokalne pre-commit hooks, aby wykrywać problemy przed pushowaniem:
pip install pre-commit pre-commit install
Uwagi
Copyleft © Artur M. Brodzki 2019-2023. Loosely based on EiTI-Szablon by Piotr Woźniak. All wrongs reserved.