41 lines
2.9 KiB
Markdown
41 lines
2.9 KiB
Markdown
# 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`.
|