Files
bm-main/CLAUDE.md

2.9 KiB
Raw Permalink Blame History

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.