Translated ['', 'AGENTS.md'] to sr

AGENTS.md

@@ -0,0 +1,80 @@
+# AGENTS.md
+
+Smernice za buduće agente koji rade u ovom repozitorijumu.
+
+## Kontekst repozitorijuma
+
+Ovo je HackTricks Cloud mdBook repozitorijum. Povezana glavna knjiga se nalazi na:
+
+`/Users/carlospolop/git/hacktricks`
+
+Promene u deljenom theme/search ponašanju često moraju da se primene u oba repozitorijuma.
+
+## Search Index Loading Contract
+
+Prilagođeni search UI se nalazi u:
+
+`theme/ht_searcher.js`
+
+Može postojati i generisana kopija na:
+
+`book/theme/ht_searcher.js`
+
+Ako se u produkciji deploy-uje već izgrađeni `book/` direktorijum, ažuriraj obe kopije ili ponovo izgradi knjigu pre deploy-a.
+
+Redosled učitavanja search index-a je važan i osetljiv na troškove:
+
+1. Učitaj svaki jezički specifičan i fallback search index iz GitHub repozitorijuma:
+`HackTricks-wiki/hacktricks-searchindex`
+2. Samo ako svi GitHub-hosted kandidati fail-uju, pređi na same-origin mdBook output.
+
+Ne stavljaj lokalni `/searchindex.js` fallback pre bilo kog GitHub-hosted fallback-a kao što je
+`searchindex-cloud-en.js.gz`. Serviranje `searchindex.js` sa `cloud.hacktricks.wiki` u produkciji je skupo.
+
+Za ovaj repozitorijum, očekivani lokalni fallback je:
+
+`/searchindex.js`
+
+Fallback glavne knjige za ovaj repozitorijum je:
+
+`/searchindex-book.js`
+
+Ta datoteka je samo fallback. Primarni izvor mora ostati remote
+`searchindex-<lang>.js.gz` i `searchindex-cloud-<lang>.js.gz` fajlovi u
+`HackTricks-wiki/hacktricks-searchindex`.
+
+## Search Index Publishing
+
+Workflows koji objavljuju encrypted compressed search indexes u
+`HackTricks-wiki/hacktricks-searchindex` su:
+
+- `.github/workflows/build_master.yml`
+- `.github/workflows/translate_all.yml`
+
+Generisana source datoteka je `book/searchindex.js`. Nazivi objavljenih remote artifact-a su:
+
+- `searchindex-cloud-en.js.gz`
+- `searchindex-cloud-<lang>.js.gz`
+
+Browser loader očekuje da su remote `.js.gz` fajlovi XOR-encrypted gzip payload-i koristeći
+ključ definisan u `theme/ht_searcher.js`.
+
+## Build And Validation
+
+Uobičajene lokalne provere:
+
+- `node --check theme/ht_searcher.js`
+- `mdbook build`
+
+Ako `mdbook build` fail-uje, proveri:
+
+- `hacktricks-preprocessor-error.log`
+- `hacktricks-preprocessor.log`
+
+## Editing Notes
+
+- Preferiraj `rg` za pretragu.
+- Drži generisani `book/` output van commit-ova osim ako nije izričito traženo. Ispravke search loader-a su izuzetak kada već izgrađene stranice moraju odmah da se poprave.
+- Ako menjaš deljeno theme ponašanje, uporedi i ažuriraj odgovarajuću datoteku u
+`/Users/carlospolop/git/hacktricks`.
+- Ne vraćaj nepovezane lokalne izmene.