Start: struktura repo, materiały z uczelni, tematy pracy, submoduł private

This commit is contained in:
Jakub Zych
2026-09-24 02:44:53 +02:00
commit d0a0e1b8a0
35 changed files with 389 additions and 0 deletions

40
CLAUDE.md Normal file
View File

@@ -0,0 +1,40 @@
# Studia – notatki i materiały
Repozytorium materiałów ze studiów magisterskich Jakuba: Bezpieczeństwo międzynarodowe (BM), II stopnia niestacjonarne, Instytut Studiów Międzynarodowych i Bezpieczeństwa (ISMiB), Wydział Nauk Społecznych UWr, od 2026/27. Nie ma tu kodu.
**Repo `bm-main` jest publiczne** – czytają je kibice z kanału na Mattermoście. Część prywatna to submoduł `private/` (`bm-private`), z własnymi zasadami:
@private/CLAUDE.md
## Co jest publiczne, a co nie
- Nie wpisuj do `bm-main` danych osobowych, ocen promotorów ani nazw i ścieżek materiałów klientów. Takie rzeczy idą do `private/`.
- Gdy plik ma wersję publiczną i prywatną, publiczna jest osobnym okrojonym plikiem (np. `praca/tematy.md` vs `private/praca/tematy-i-promotorzy.md`).
- Przed commitem w `bm-main` sprawdź diff pod tym kątem.
## Język i styl
- Rozmowa i wszystkie pliki .md po polsku. Nazwy przedmiotów, instytucji i tytuły dokumentów w oryginalnym brzmieniu.
- Tytuły naukowe pisz tak jak uczelnia: „dr hab. X, prof. UWr”.
## Struktura
- `materialy/szkola/` – główny katalog. Przedmioty jako `<przedmiot-slug>/<semestr>/`, np. `antropologia-wojny/sem1_zima-2026-27/`. Mapa programu w `materialy/szkola/README.md`.
- `materialy/szkola/dokumenty/` – pliki z uczelni: `program/`, `plany-zajec/`, `organizacyjne/`.
- `materialy/zrodla/` – literatura przekrojowa. `materialy/porownawcze/` – programy innych kierunków i uczelni.
- `praca/` – praca magisterska.
- Każdy katalog ma `README.md` z celem katalogu. Nowy katalog = nowy README.
## Konwencje nazw plików
- Slugi katalogów: małe litery, bez polskich znaków, myślniki (`teoria-i-metodologia-nauk-o-bezpieczenstwie`).
- Semestry: `sem<N>_<zima|lato>-<rok>`, np. `sem1_zima-2026-27`, `sem2_lato-2027`.
- Notatki z zajęć: `RRRR-MM-DD_<temat>.md`.
- Plany zajęć: `<rok>_<zima|lato>_<rok-studiów>.pdf`, np. `2026-27_zima_I-rok.pdf`. Rok akademicki jako `2026-27`.
- W `materialy/szkola/` bez prefiksu kierunku (repo i tak jest o BM). W `materialy/porownawcze/` prefiks kierunku zostaje: `<KIERUNEK><stopień>_<co>_<zakres>.<ext>`.
- Pliki ściągnięte z uczelni: nazwę można ujednolicić, treści nie zmieniaj.
## Praca z plikami
- PDF czytaj przez `pdftotext -layout`; .odt przez rozpakowanie `content.xml`; zapisane HTML przez skrypt Pythona z `re` + `html.unescape`. Plany zajęć to tabele, czytaj je z `-layout`.
- Notatki dopisuj na końcu istniejących plików .md z datowanym nagłówkiem (`# ... (DD.MM.RRRR)`), nie nadpisuj wcześniejszych sekcji.
- Plany zajęć ISMiB leżą pod `ismb.uwr.edu.pl/wp-content/uploads/sites/366/<rok>/<mm>/bm_niestacjonarne_<semestr>.pdf`; strona instytutu nie linkuje ich w HTML, trzeba zgadywać ścieżkę.
## Git
- Commituj tylko na prośbę. Bez tagów co-author w wiadomościach.
- Zmiana w `private/`: najpierw commit i push w submodule, potem commit wskaźnika w `bm-main`.