mirror of
				https://github.com/HackTricks-wiki/hacktricks.git
				synced 2025-10-10 18:36:50 +00:00 
			
		
		
		
	Translated ['', 'src/welcome/hacktricks-values-and-faq.md'] to uk
This commit is contained in:
		
							parent
							
								
									c9f44355ba
								
							
						
					
					
						commit
						19cb25ea62
					
				| @ -1,21 +1,21 @@ | ||||
| # Цінності HackTricks і FAQ | ||||
| # Цінності HackTricks та FAQ | ||||
| 
 | ||||
| {{#include ../banners/hacktricks-training.md}} | ||||
| 
 | ||||
| ## Цінності HackTricks | ||||
| 
 | ||||
| > [!TIP] | ||||
| > Ось **цінності проєкту HackTricks**: | ||||
| > Це **цінності проєкту HackTricks**: | ||||
| > | ||||
| > - Забезпечити **БЕЗКОШТОВНИЙ** доступ до **ОСВІТНІХ hacking** ресурсів для **ВСІХ** користувачів Інтернету. | ||||
| >  - Hacking — це про навчання, і навчання має бути якомога безкоштовним. | ||||
| >  - Метою цієї книги є служити як всебічний **освітній ресурс**. | ||||
| > - **ЗБЕРІГАТИ** відмінні **hacking** техніки, які публікує спільнота, віддаючи **ОРИГІНАЛЬНИМ** **АВТОРАМ** все **визнання**. | ||||
| >  - **Ми не прагнемо чужого визнання**, ми просто хочемо зберігати круті трюки для всіх. | ||||
| >  - Ми також пишемо **наші власні дослідження** в HackTricks. | ||||
| >  - У деяких випадках ми просто напишемо **в HackTricks резюме важливих частин** техніки та будемо **заохочувати читача відвідати оригінальний допис** для отримання детальнішої інформації. | ||||
| > - **ОРГАНІЗОВУВАТИ** всі hacking техніки в книзі, щоб вони були **БІЛЬШ ДОСТУПНИМИ** | ||||
| >  - Команда HackTricks присвятила тисячі годин безкоштовно **тільки для організації контенту**, щоб люди могли **вчитися швидше** | ||||
| > - Надавати **БЕЗКОШТОВНИЙ** доступ до **ОСВІТНІХ hacking** ресурсів для **ВСЬОГО** Інтернету. | ||||
| >  - Hacking полягає в навчанні, і навчання має бути якомога більш вільним. | ||||
| >  - Метою цієї книги є слугувати всеохоплюючим **освітнім ресурсом**. | ||||
| > - **ЗБЕРІГАТИ** чудові **hacking** техніки, які публікує спільнота, надаючи **ОРИГІНАЛЬНИМ** **АВТОРАМ** усе **визнання**. | ||||
| >  - **Ми не хочемо привласнювати заслуги інших людей**, ми просто хочемо зберігати класні трюки для всіх. | ||||
| >  - Ми також пишемо **власні дослідження** у HackTricks. | ||||
| >  - У кількох випадках ми просто напишемо **у HackTricks стислий виклад важливих частин** техніки і **закликатимемо читача відвідати оригінальну публікацію** для деталей. | ||||
| > - **ОРГАНІЗОВУВАТИ** всі hacking техніки в книзі, щоб вона була **БІЛЬШ ДОСТУПНОЮ** | ||||
| >  - Команда HackTricks присвятила тисячі годин безкоштовно **лише на організацію контенту**, щоб люди могли **вчитися швидше** | ||||
| 
 | ||||
| <figure><img src="../images/hack tricks gif.gif" alt="" width="375"><figcaption></figcaption></figure> | ||||
| 
 | ||||
| @ -23,35 +23,34 @@ | ||||
| 
 | ||||
| > [!TIP] | ||||
| > | ||||
| > - **Дуже дякую за ці ресурси, як я можу подякувати?** | ||||
| > - **Дякуємо вам за ці ресурси, як я можу подякувати?** | ||||
| 
 | ||||
| Ви можете публічно подякувати командам HackTricks за збирання всіх цих ресурсів, опублікувавши твіт із згадкою [**@hacktricks_live**](https://twitter.com/hacktricks_live).\ | ||||
| Якщо ви особливо вдячні, ви також можете [**підтримати проект тут**](https://github.com/sponsors/carlospolop).\ | ||||
| І не забудьте **поставити зірку у проектах на Github!** (Посилання нижче). | ||||
| Ви можете публічно подякувати командам HackTricks за збирання всіх цих ресурсів у твіті, зазначивши [**@hacktricks_live**](https://twitter.com/hacktricks_live).\ | ||||
| Якщо ви особливо вдячні, ви також можете [**підтримати проєкт тут**](https://github.com/sponsors/carlospolop).\ | ||||
| І не забудьте **поставити зірку проєктам на Github!** (Посилання нижче). | ||||
| 
 | ||||
| > [!TIP] | ||||
| > | ||||
| > - **Як я можу зробити внесок у проект?** | ||||
| > - **Як я можу долучитися до проєкту?** | ||||
| 
 | ||||
| Ви можете **поділитися новими порадами та трюками зі спільнотою або виправити баги**, які знайдете в книгах, надіславши **Pull Request** на відповідні сторінки Github: | ||||
| Ви можете **поділитися новими порадами та трюками зі спільнотою або виправити баги** які ви знайдете в книгах, надіславши **Pull Request** на відповідні сторінки Github: | ||||
| 
 | ||||
| - [https://github.com/carlospolop/hacktricks](https://github.com/carlospolop/hacktricks) | ||||
| - [https://github.com/carlospolop/hacktricks-cloud](https://github.com/carlospolop/hacktricks-cloud) | ||||
| 
 | ||||
| Не забудьте **поставити зірку у проектах на Github!** | ||||
| Не забудьте **поставити зірку проєктам на Github!** | ||||
| 
 | ||||
| > [!TIP] | ||||
| > | ||||
| > - **Чи можу я скопіювати частину контенту з HackTricks і розмістити її в своєму блозі?** | ||||
| > - **Чи можу я скопіювати частину контенту з HackTricks і опублікувати його у своєму блозі?** | ||||
| 
 | ||||
| Так, можете, але **не забудьте вказати конкретні посилання**, звідки взято контент. | ||||
| Так, можна, але **не забудьте вказати конкретні посилання**, звідки було взято контент. | ||||
| 
 | ||||
| > [!TIP] | ||||
| > | ||||
| > - **Як цитувати сторінку HackTricks?** | ||||
| > - **Як я можу посилатися на сторінку HackTricks?** | ||||
| 
 | ||||
| Достатньо вказати посилання на сторінку(и), звідки ви взяли інформацію.\ | ||||
| Якщо вам потрібен bibtex, ви можете використати щось на кшталт: | ||||
| Достатньо, щоб з'явилася посилання **на** сторінку(и), звідки ви взяли інформацію.\ Якщо вам потрібен bibtex, ви можете використати щось на кшталт: | ||||
| ```latex | ||||
| @misc{hacktricks-bibtexing, | ||||
| author = {"HackTricks Team" or the Authors name of the specific page/trick}, | ||||
| @ -64,27 +63,27 @@ url = {\url{https://book.hacktricks.wiki/specific-page}}, | ||||
| > | ||||
| > - **Can I copy all HackTricks in my blog?** | ||||
| 
 | ||||
| **Я б радше ні**. Це **не принесе користі нікому**, оскільки весь **вміст уже публічно доступний** в офіційних книгах HackTricks безкоштовно. | ||||
| **Краще ні**. Це **нікому не принесе користі**, оскільки весь **контент вже публічно доступний** в офіційних книгах HackTricks безкоштовно. | ||||
| 
 | ||||
| Якщо ви боїтеся, що це зникне, просто зробіть fork на Github або завантажте його, як я вже сказав — воно вже БЕЗКОШТОВНО. | ||||
| Якщо ви боїтеся, що він зникне — просто форкніть репозиторій на Github або завантажте його; як я вже сказав, він вже безкоштовний. | ||||
| 
 | ||||
| > [!WARNING] | ||||
| > | ||||
| > - **Why do you have sponsors? Are HackTricks books for commercial purposes?** | ||||
| 
 | ||||
| Першою **цінністю** HackTricks є надання **БЕЗКОШТОВНИХ** освітніх ресурсів з хакінгу **ВСЬОМУ** світу. Команда HackTricks **присвятила тисячі годин**, щоб надати цей вміст, знову ж таки — **БЕЗКОШТОВНО**. | ||||
| Першою **цінністю** HackTricks є надання **БЕЗКОШТОВНИХ** освітніх ресурсів з хакінгу **ВСЬОМУ** світу. Команда HackTricks присвятила **тисячі годин**, щоб надати цей контент, знову ж таки — **БЕЗКОШТОВНО**. | ||||
| 
 | ||||
| Якщо ви думаєте, що книги HackTricks створені для **комерційних цілей**, ви **ЦЕ ПОВНІСТЮ НЕПРАВДА**. | ||||
| Якщо ви вважаєте, що книги HackTricks створені з **комерційною метою**, ви **ПОВНІСТЮ ПОМИЛЯЄТЕСЯ**. | ||||
| 
 | ||||
| Ми маємо спонсорів, тому що, навіть якщо весь вміст БЕЗКОШТОВНИЙ, ми хочемо **дати спільноті можливість оцінити нашу роботу**, якщо вони цього бажають. Тому ми пропонуємо людям опцію пожертвувати HackTricks через [**Github sponsors**](https://github.com/sponsors/carlospolop), а також **відповідні компанії з кібербезпеки** можуть спонсорувати HackTricks і розміщувати **оголошення** у книзі — ці **оголошення** завжди розміщуються так, щоб бути **помітними**, але **не заважати** процесу навчання, якщо хтось зосереджений на вмісті. | ||||
| У нас є спонсори, бо, навіть якщо весь контент БЕЗКОШТОВНИЙ, ми хочемо надати спільноті можливість **оцінити нашу роботу**, якщо вони цього бажають. Тому ми пропонуємо людям опцію робити донати HackTricks через [**Github sponsors**](https://github.com/sponsors/carlospolop), а також дозволяємо **відповідним компаніям з кібербезпеки** спонсорувати HackTricks і розміщувати **деякі оголошення** в книзі — ці оголошення завжди розміщені в місцях, де вони **помітні**, але **не заважають процесу навчання**, якщо хтось зосереджений на контенті. | ||||
| 
 | ||||
| Ви не знайдете HackTricks заповненим дратівливими оголошеннями, як інші блоги з набагато меншим вмістом, тому що HackTricks не створювався з комерційною метою. | ||||
| Ви не знайдете HackTricks, заповнений дратівливими оголошеннями, як на деяких блогах з набагато меншим контентом, бо HackTricks не створений з комерційною метою. | ||||
| 
 | ||||
| > [!CAUTION] | ||||
| > | ||||
| > - **What should I do if some HackTricks page is based on my blog post but it isn't referenced?** | ||||
| 
 | ||||
| **Нам дуже шкода. Такого не повинно було статися**. Будь ласка, повідомте нам через Github issues, Twitter, Discord... посилання на сторінку HackTricks з відповідним вмістом і посилання на ваш блог — **ми перевіримо це і додамо посилання ЯКНАЙШВИДШЕ**. | ||||
| **Нам дуже шкода. Так не мало б статися**. Повідомте нам через Github issues, Twitter, Discord... надішліть посилання на сторінку HackTricks з відповідним контентом та посилання на ваш блог, і **ми перевіримо це і додамо посилання якнайшвидше**. | ||||
| 
 | ||||
| > [!CAUTION] | ||||
| > | ||||
| @ -93,51 +92,51 @@ url = {\url{https://book.hacktricks.wiki/specific-page}}, | ||||
| Зауважте, що наявність посилань на вашу сторінку в HackTricks: | ||||
| 
 | ||||
| - Покращує вашу **SEO** | ||||
| - Вміст **перекладається більш ніж на 15 мов**, що дає змогу більшій кількості людей отримати доступ до цього матеріалу | ||||
| - **HackTricks заохочує** людей **переглядати вашу сторінку** (декілька людей повідомляли нам, що з тих пір, як якась їхня сторінка з'явилася в HackTricks, вони отримали більше відвідувачів) | ||||
| - Контент **перекладається більш ніж на 15 мов**, що дозволяє більшій кількості людей отримати доступ до матеріалу | ||||
| - **HackTricks заохочує** людей **переглядати вашу сторінку** (кілька авторів повідомляли, що з появою їхньої сторінки в HackTricks вони отримали більше відвідувань) | ||||
| 
 | ||||
| Однак, якщо ви все ще хочете, щоб вміст вашого блогу був видалений з HackTricks, просто повідомте нам, і ми обов'язково **видалимо всі посилання на ваш блог** та будь-який вміст, що на ньому базується. | ||||
| Однак, якщо ви все ще хочете, щоб контент вашого блогу був видалений з HackTricks — просто повідомте нас, і ми **безумовно видалимо всі посилання на ваш блог** та будь-який контент, який на ньому базується. | ||||
| 
 | ||||
| > [!CAUTION] | ||||
| > | ||||
| > - **What should I do if I find copy-pasted content in HackTricks?** | ||||
| 
 | ||||
| Ми завжди **надаємо оригінальним авторам усі кредити**. Якщо ви знайдете сторінку з копіпастою без посилання на джерело, повідомте нам, і ми або **видалимо її**, або **додамо посилання перед текстом**, або **перепишемо її, додавши посилання**. | ||||
| Ми завжди **віддаємо всім оригінальним авторам належні кредити**. Якщо ви знайдете сторінку з контентом, скопійованим без вказання джерела, повідомте нас і ми або **видалимо її**, або **додамо посилання перед текстом**, або **перепишемо з додаванням посилання**. | ||||
| 
 | ||||
| ## LICENSE | ||||
| 
 | ||||
| Авторське право © Усі права захищені, якщо не вказано інше. | ||||
| Авторське право © Всі права захищені, якщо не вказано інше. | ||||
| 
 | ||||
| #### License Summary: | ||||
| 
 | ||||
| - Attribution: You are free to: | ||||
| - Share — копіювати та поширювати матеріал у будь-якому середовищі чи форматі. | ||||
| - Adapt — реміксувати, трансформувати та створювати похідні матеріали на основі матеріалу. | ||||
| - Attribution: Ви маєте право: | ||||
| - Share — копіювати та поширювати матеріал у будь-якому середовищі та форматі. | ||||
| - Adapt — реміксувати, трансформувати та створювати похідні матеріали. | ||||
| 
 | ||||
| #### Additional Terms: | ||||
| 
 | ||||
| - Third-Party Content: Деякі частини цього блогу/книги можуть включати вміст з інших джерел, таких як витяги з інших блогів або публікацій. Використання такого вмісту здійснюється відповідно до принципів fair use або з явного дозволу відповідних правовласників. Будь ласка, звертайтеся до оригінальних джерел для отримання конкретної інформації про ліцензування стороннього вмісту. | ||||
| - Authorship: Оригінальний вміст, створений HackTricks, підпадає під умови цієї ліцензії. Рекомендується вказувати авторство цієї роботи при її поширенні або адаптації. | ||||
| - Third-Party Content: Деякі частини цього блогу/книги можуть включати матеріали з інших джерел, такі як витяги з інших блогів або публікацій. Використання такого контенту здійснюється на засадах добросовісного використання або з явного дозволу відповідних правовласників. Будь ласка, звертайтеся до оригінальних джерел для отримання конкретної інформації про ліцензування стороннього контенту. | ||||
| - Authorship: Оригінальний контент, створений HackTricks, підпадає під умови цієї ліцензії. Рекомендується вказувати авторство при поширенні або адаптації цього матеріалу. | ||||
| 
 | ||||
| #### Exemptions: | ||||
| 
 | ||||
| - Commercial Use: Для запитів щодо комерційного використання цього вмісту, будь ласка, зв'яжіться зі мною. | ||||
| - Commercial Use: Для запитів щодо комерційного використання цього контенту, будь ласка, зв'яжіться зі мною. | ||||
| 
 | ||||
| Ця ліцензія не надає жодних прав на торгові марки або бренд у зв'язку з вмістом. Усі торгові марки та бренди, що фігурують у цьому блозі/книзі, належать їх відповідним власникам. | ||||
| Ця ліцензія не надає жодних прав на торговельні марки або брендинг, пов'язані з контентом. Усі торговельні марки та бренди, що згадані в цьому блозі/книзі, належать відповідним власникам. | ||||
| 
 | ||||
| **Отримуючи доступ або використовуючи HackTricks, ви погоджуєтеся дотримуватися умов цієї ліцензії. Якщо ви не погоджуєтеся з цими умовами, будь ласка, не заходьте на цей вебсайт.** | ||||
| **Отримуючи доступ до HackTricks або використовуючи його, ви погоджуєтесь дотримуватись умов цієї ліцензії. Якщо ви не згодні з цими умовами, будь ласка, не заходьте на цей сайт.** | ||||
| 
 | ||||
| ## **Відмова від відповідальності** | ||||
| ## **Застереження** | ||||
| 
 | ||||
| > [!CAUTION] | ||||
| > Ця книга, 'HackTricks', призначена виключно для освітніх та інформаційних цілей. Вміст цієї книги надається "як є", і автори та видавці не роблять жодних заяв або гарантій будь-якого роду, явних чи імпліцитних, щодо повноти, точності, надійності, придатності або доступності інформації, продуктів, послуг або пов'язаних графічних матеріалів, що містяться в цій книзі. Будь-яка довіра, яку ви покладаєте на таку інформацію, здійснюється виключно на ваш страх і ризик. | ||||
| > Ця книга, 'HackTricks', призначена виключно для освітніх і інформаційних цілей. Контент цієї книги надається "як є", і автори та видавці не дають жодних заяв або гарантій будь-якого роду, явних чи неявних, щодо повноти, точності, надійності, придатності або доступності інформації, продуктів, послуг або пов'язаних графічних матеріалів, що містяться в цій книзі. Будь-яке покладання на таку інформацію здійснюється виключно на ваш власний ризик. | ||||
| > | ||||
| > Автори та видавці жодним чином не несуть відповідальності за будь-які збитки або втрати, включаючи, без обмежень, побічні або наслідкові збитки, або будь-які збитки чи втрати, що виникають у зв'язку з втратою даних або прибутків у зв'язку з використанням цієї книги. | ||||
| > Автори та видавці ні в якому разі не нестимуть відповідальності за будь-які збитки або втрати, включно, але не обмежуючись, непрямими або наслідковими збитками, або будь-якими іншими збитками, що виникають через втрату даних або прибутку внаслідок або у зв'язку з використанням цієї книги. | ||||
| > | ||||
| > Крім того, техніки та поради, описані в цій книзі, надаються лише в освітніх і інформаційних цілях і не повинні використовуватися для будь-яких незаконних або зловмисних дій. Автори та видавці не підтримують і не заохочують жодних незаконних або неетичних дій, і будь-яке використання інформації, що міститься в цій книзі, відбувається на власний ризик і розсуд користувача. | ||||
| > Крім того, техніки та поради, описані в цій книзі, надаються лише в освітніх та інформаційних цілях і не повинні використовуватися для незаконних або шкідливих дій. Автори та видавці не сприймають і не підтримують жодних незаконних або неетичних дій, і будь-яке використання інформації з цієї книги здійснюється на власний ризик і розсуд користувача. | ||||
| > | ||||
| > Користувач несе повну відповідальність за будь-які дії, вжиті на підставі інформації, що міститься в цій книзі, і завжди повинен звертатися за професійною порадою та допомогою при спробі реалізувати будь-які з описаних технік або порад. | ||||
| > Користувач несе повну відповідальність за будь-які дії, вжиті на основі інформації, що міститься в цій книзі, і повинен завжди звертатися за професійною порадою та допомогою при спробі реалізувати будь-які описані техніки чи поради. | ||||
| > | ||||
| > Використовуючи цю книгу, користувач погоджується звільнити авторів і видавців від будь-якої відповідальності за будь-які збитки, втрати або шкоду, які можуть виникнути внаслідок використання цієї книги або будь-якої інформації, що в ній міститься. | ||||
| > Використовуючи цю книгу, користувач погоджується звільнити авторів і видавців від будь-якої відповідальності за збитки, втрати або шкоду, які можуть виникнути внаслідок використання цієї книги або будь-якої інформації, що міститься в ній. | ||||
| 
 | ||||
| {{#include ../banners/hacktricks-training.md}} | ||||
|  | ||||
| @ -6,34 +6,63 @@ | ||||
| */ | ||||
| 
 | ||||
| (() => { | ||||
|   "use strict"; | ||||
|     "use strict"; | ||||
|    | ||||
|     /* ───────────── 0. helpers (main thread) ───────────── */ | ||||
|     const clear = el => { while (el.firstChild) el.removeChild(el.firstChild); }; | ||||
|    | ||||
|     /* ───────────── 1. Web‑Worker code ─────────────────── */ | ||||
|     const workerCode = ` | ||||
|       self.window = self; | ||||
|       self.search = self.search || {}; | ||||
|       const abs = p => location.origin + p; | ||||
|    | ||||
|       /* 1 — elasticlunr */ | ||||
|       try { importScripts('https://cdn.jsdelivr.net/npm/elasticlunr@0.9.5/elasticlunr.min.js'); } | ||||
|       catch { importScripts(abs('/elasticlunr.min.js')); } | ||||
|    | ||||
|     /* 2 — decompress gzip data */ | ||||
|     async function decompressGzip(arrayBuffer){ | ||||
|       if(typeof DecompressionStream !== 'undefined'){ | ||||
|         /* Modern browsers: use native DecompressionStream */ | ||||
|         const stream = new Response(arrayBuffer).body.pipeThrough(new DecompressionStream('gzip')); | ||||
|         const decompressed = await new Response(stream).arrayBuffer(); | ||||
|         return new TextDecoder().decode(decompressed); | ||||
|       } else { | ||||
|         /* Fallback: use pako library */ | ||||
|         if(typeof pako === 'undefined'){ | ||||
|           try { importScripts('https://cdn.jsdelivr.net/npm/pako@2.1.0/dist/pako.min.js'); } | ||||
|           catch(e){ throw new Error('pako library required for decompression: '+e); } | ||||
|         } | ||||
|         const uint8Array = new Uint8Array(arrayBuffer); | ||||
|         const decompressed = pako.ungzip(uint8Array, {to: 'string'}); | ||||
|         return decompressed; | ||||
|       } | ||||
|     } | ||||
| 
 | ||||
|   /* ───────────── 0. helpers (main thread) ───────────── */ | ||||
|   const clear = el => { while (el.firstChild) el.removeChild(el.firstChild); }; | ||||
| 
 | ||||
|   /* ───────────── 1. Web‑Worker code ─────────────────── */ | ||||
|   const workerCode = ` | ||||
|     self.window = self; | ||||
|     self.search = self.search || {}; | ||||
|     const abs = p => location.origin + p; | ||||
| 
 | ||||
|     /* 1 — elasticlunr */ | ||||
|     try { importScripts('https://cdn.jsdelivr.net/npm/elasticlunr@0.9.5/elasticlunr.min.js'); } | ||||
|     catch { importScripts(abs('/elasticlunr.min.js')); } | ||||
| 
 | ||||
|     /* 2 — load a single index (remote → local) */ | ||||
|     /* 3 — load a single index (remote → local) */ | ||||
|     async function loadIndex(remote, local, isCloud=false){ | ||||
|       let rawLoaded = false; | ||||
|       if(remote){ | ||||
|         /* Try ONLY compressed version from GitHub (remote already includes .js.gz) */ | ||||
|         try { | ||||
|           const r = await fetch(remote,{mode:'cors'}); | ||||
|           if (!r.ok) throw new Error('HTTP '+r.status); | ||||
|           importScripts(URL.createObjectURL(new Blob([await r.text()],{type:'application/javascript'}))); | ||||
|           rawLoaded = true; | ||||
|         } catch(e){ console.warn('remote',remote,'failed →',e); } | ||||
|           if (r.ok) { | ||||
|             const compressed = await r.arrayBuffer(); | ||||
|             const text = await decompressGzip(compressed); | ||||
|             importScripts(URL.createObjectURL(new Blob([text],{type:'application/javascript'}))); | ||||
|             rawLoaded = true; | ||||
|             console.log('Loaded compressed from GitHub:',remote); | ||||
|           } | ||||
|         } catch(e){ console.warn('compressed GitHub',remote,'failed →',e); } | ||||
|       } | ||||
|       /* If remote (GitHub) failed, fall back to local uncompressed file */ | ||||
|       if(!rawLoaded && local){ | ||||
|         try { importScripts(abs(local)); rawLoaded = true; } | ||||
|         try {  | ||||
|           importScripts(abs(local));  | ||||
|           rawLoaded = true; | ||||
|           console.log('Loaded local fallback:',local); | ||||
|         } | ||||
|         catch(e){ console.error('local',local,'failed →',e); } | ||||
|       } | ||||
|       if(!rawLoaded) return null;                 /* give up on this index */ | ||||
| @ -61,151 +90,159 @@ | ||||
| 
 | ||||
|       return local ? loadIndex(null, local, isCloud) : null; | ||||
|     } | ||||
|      | ||||
|     let built = []; | ||||
|     const MAX = 30, opts = {bool:'AND', expand:true}; | ||||
|      | ||||
|     self.onmessage = async ({data}) => { | ||||
|       if(data.type === 'init'){ | ||||
|         const lang = data.lang || 'en'; | ||||
|         const searchindexBase = 'https://raw.githubusercontent.com/HackTricks-wiki/hacktricks-searchindex/master'; | ||||
| 
 | ||||
|     (async () => { | ||||
|       const htmlLang = (document.documentElement.lang || 'en').toLowerCase(); | ||||
|       const lang = htmlLang.split('-')[0]; | ||||
|       const mainReleaseBase = 'https://github.com/HackTricks-wiki/hacktricks/releases/download'; | ||||
|       const cloudReleaseBase = 'https://github.com/HackTricks-wiki/hacktricks-cloud/releases/download'; | ||||
|         /* Remote sources are .js.gz (compressed), local fallback is .js (uncompressed) */ | ||||
|         const mainFilenames = Array.from(new Set(['searchindex-' + lang + '.js.gz', 'searchindex-en.js.gz'])); | ||||
|         const cloudFilenames = Array.from(new Set(['searchindex-cloud-' + lang + '.js.gz', 'searchindex-cloud-en.js.gz'])); | ||||
| 
 | ||||
|       const mainTags = Array.from(new Set([\`searchindex-\${lang}\`, 'searchindex-en', 'searchindex-master']));
 | ||||
|       const cloudTags = Array.from(new Set([\`searchindex-\${lang}\`, 'searchindex-en', 'searchindex-master']));
 | ||||
|         const MAIN_REMOTE_SOURCES  = mainFilenames.map(function(filename) { return searchindexBase + '/' + filename; }); | ||||
|         const CLOUD_REMOTE_SOURCES = cloudFilenames.map(function(filename) { return searchindexBase + '/' + filename; }); | ||||
| 
 | ||||
|       const MAIN_REMOTE_SOURCES  = mainTags.map(tag => \`\${mainReleaseBase}/\${tag}/searchindex.js\`);
 | ||||
|       const CLOUD_REMOTE_SOURCES = cloudTags.map(tag => \`\${cloudReleaseBase}/\${tag}/searchindex.js\`);
 | ||||
| 
 | ||||
|       const indices = []; | ||||
|       const main = await loadWithFallback(MAIN_REMOTE_SOURCES , '/searchindex.js',        false); if(main)  indices.push(main); | ||||
|       const cloud= await loadWithFallback(CLOUD_REMOTE_SOURCES, '/searchindex-cloud.js',  true ); if(cloud) indices.push(cloud); | ||||
| 
 | ||||
|       if(!indices.length){ postMessage({ready:false, error:'no-index'}); return; } | ||||
| 
 | ||||
|       /* build index objects */ | ||||
|       const built = indices.map(d => ({ | ||||
|         idx : elasticlunr.Index.load(d.json), | ||||
|         urls: d.urls, | ||||
|         cloud: d.cloud, | ||||
|         base: d.cloud ? 'https://cloud.hacktricks.wiki/' : '' | ||||
|       })); | ||||
| 
 | ||||
|       postMessage({ready:true}); | ||||
|       const MAX = 30, opts = {bool:'AND', expand:true}; | ||||
| 
 | ||||
|       self.onmessage = ({data:q}) => { | ||||
|         if(!q){ postMessage([]); return; } | ||||
| 
 | ||||
|         const all = []; | ||||
|         for(const s of built){ | ||||
|           const res = s.idx.search(q,opts); | ||||
|           if(!res.length) continue; | ||||
|           const max = res[0].score || 1; | ||||
|           res.forEach(r => { | ||||
|             const doc = s.idx.documentStore.getDoc(r.ref); | ||||
|             all.push({ | ||||
|               norm : r.score / max, | ||||
|               title: doc.title, | ||||
|               body : doc.body, | ||||
|               breadcrumbs: doc.breadcrumbs, | ||||
|               url  : s.base + s.urls[r.ref], | ||||
|               cloud: s.cloud | ||||
|         const indices = []; | ||||
|         const main = await loadWithFallback(MAIN_REMOTE_SOURCES , '/searchindex-book.js',        false); if(main)  indices.push(main); | ||||
|         const cloud= await loadWithFallback(CLOUD_REMOTE_SOURCES, '/searchindex.js',  true ); if(cloud) indices.push(cloud);   | ||||
|         if(!indices.length){ postMessage({ready:false, error:'no-index'}); return; } | ||||
|    | ||||
|         /* build index objects */ | ||||
|         built = indices.map(d => ({ | ||||
|           idx : elasticlunr.Index.load(d.json), | ||||
|           urls: d.urls, | ||||
|           cloud: d.cloud, | ||||
|           base: d.cloud ? 'https://cloud.hacktricks.wiki/' : '' | ||||
|         })); | ||||
|    | ||||
|         postMessage({ready:true}); | ||||
|         return; | ||||
|       } | ||||
|        | ||||
|       const q = data.query || data; | ||||
|       if(!q){ postMessage([]); return; } | ||||
|    | ||||
|           const all = []; | ||||
|           for(const s of built){ | ||||
|             const res = s.idx.search(q,opts); | ||||
|             if(!res.length) continue; | ||||
|             const max = res[0].score || 1; | ||||
|             res.forEach(r => { | ||||
|               const doc = s.idx.documentStore.getDoc(r.ref); | ||||
|               all.push({ | ||||
|                 norm : r.score / max, | ||||
|                 title: doc.title, | ||||
|                 body : doc.body, | ||||
|                 breadcrumbs: doc.breadcrumbs, | ||||
|                 url  : s.base + s.urls[r.ref], | ||||
|                 cloud: s.cloud | ||||
|               }); | ||||
|             }); | ||||
|           }); | ||||
|         } | ||||
|         all.sort((a,b)=>b.norm-a.norm); | ||||
|         postMessage(all.slice(0,MAX)); | ||||
|       }; | ||||
|     })(); | ||||
|   `;
 | ||||
|           } | ||||
|           all.sort((a,b)=>b.norm-a.norm); | ||||
|           postMessage(all.slice(0,MAX)); | ||||
|     }; | ||||
|     `;
 | ||||
|    | ||||
|     /* ───────────── 2. spawn worker ───────────── */ | ||||
|     const worker = new Worker(URL.createObjectURL(new Blob([workerCode],{type:'application/javascript'}))); | ||||
|      | ||||
|     /* ───────────── 2.1. initialize worker with language ───────────── */ | ||||
|     const htmlLang = (document.documentElement.lang || 'en').toLowerCase(); | ||||
|     const lang = htmlLang.split('-')[0]; | ||||
|     worker.postMessage({type: 'init', lang: lang}); | ||||
|    | ||||
|     /* ───────────── 3. DOM refs ─────────────── */ | ||||
|     const wrap    = document.getElementById('search-wrapper'); | ||||
|     const bar     = document.getElementById('searchbar'); | ||||
|     const list    = document.getElementById('searchresults'); | ||||
|     const listOut = document.getElementById('searchresults-outer'); | ||||
|     const header  = document.getElementById('searchresults-header'); | ||||
|     const icon    = document.getElementById('search-toggle'); | ||||
|    | ||||
|     const READY_ICON = icon.innerHTML; | ||||
|     icon.textContent = '⏳'; | ||||
|     icon.setAttribute('aria-label','Loading search …'); | ||||
|       icon.setAttribute('title','Search is loading, please wait...'); | ||||
| 
 | ||||
|   /* ───────────── 2. spawn worker ───────────── */ | ||||
|   const worker = new Worker(URL.createObjectURL(new Blob([workerCode],{type:'application/javascript'}))); | ||||
| 
 | ||||
|   /* ───────────── 3. DOM refs ─────────────── */ | ||||
|   const wrap    = document.getElementById('search-wrapper'); | ||||
|   const bar     = document.getElementById('searchbar'); | ||||
|   const list    = document.getElementById('searchresults'); | ||||
|   const listOut = document.getElementById('searchresults-outer'); | ||||
|   const header  = document.getElementById('searchresults-header'); | ||||
|   const icon    = document.getElementById('search-toggle'); | ||||
| 
 | ||||
|   const READY_ICON = icon.innerHTML; | ||||
|   icon.textContent = '⏳'; | ||||
|   icon.setAttribute('aria-label','Loading search …'); | ||||
|   icon.setAttribute('title','Search is loading, please wait...'); | ||||
| 
 | ||||
|   const HOT=83, ESC=27, DOWN=40, UP=38, ENTER=13; | ||||
|   let debounce, teaserCount=0; | ||||
| 
 | ||||
|   /* ───────────── helpers (teaser, metric) ───────────── */ | ||||
|   const escapeHTML = (()=>{const M={'&':'&','<':'<','>':'>','"':'"','\'':'''};return s=>s.replace(/[&<>'"]/g,c=>M[c]);})(); | ||||
|   const URL_MARK='highlight'; | ||||
|   function metric(c,t){return c?`${c} search result${c>1?'s':''} for '${t}':`:`No search results for '${t}'.`;} | ||||
| 
 | ||||
|   function makeTeaser(body,terms){ | ||||
|     const stem=w=>elasticlunr.stemmer(w.toLowerCase()); | ||||
|     const T=terms.map(stem),W_S=40,W_F=8,W_N=2,WIN=30; | ||||
|     const W=[],sents=body.toLowerCase().split('. '); | ||||
|     let i=0,v=W_F,found=false; | ||||
|     sents.forEach(s=>{v=W_F; s.split(' ').forEach(w=>{ if(w){ if(T.some(t=>stem(w).startsWith(t))){v=W_S;found=true;} W.push([w,v,i]); v=W_N;} i+=w.length+1; }); i++;}); | ||||
|     if(!W.length) return body; | ||||
|     const win=Math.min(W.length,WIN); | ||||
|     const sums=[W.slice(0,win).reduce((a,[,wt])=>a+wt,0)]; | ||||
|     for(let k=1;k<=W.length-win;k++) sums[k]=sums[k-1]-W[k-1][1]+W[k+win-1][1]; | ||||
|     const best=found?sums.lastIndexOf(Math.max(...sums)):0; | ||||
|     const out=[]; i=W[best][2]; | ||||
|     for(let k=best;k<best+win;k++){const [w,wt,pos]=W[k]; if(i<pos){out.push(body.substring(i,pos)); i=pos;} if(wt===W_S) out.push('<em>'); out.push(body.substr(pos,w.length)); if(wt===W_S) out.push('</em>'); i=pos+w.length;} | ||||
|     return out.join(''); | ||||
|   } | ||||
| 
 | ||||
|   function format(d,terms){ | ||||
|     const teaser=makeTeaser(escapeHTML(d.body),terms); | ||||
|     teaserCount++; | ||||
|     const enc=encodeURIComponent(terms.join(' ')).replace(/'/g,'%27'); | ||||
|     const parts=d.url.split('#'); if(parts.length===1) parts.push(''); | ||||
|     const abs=d.url.startsWith('http'); | ||||
|     const href=`${abs?'':path_to_root}${parts[0]}?${URL_MARK}=${enc}#${parts[1]}`; | ||||
|     const style=d.cloud?" style=\"color:#1e88e5\"":""; | ||||
|     const isCloud=d.cloud?" [Cloud]":" [Book]"; | ||||
|     return `<a href="${href}" aria-details="teaser_${teaserCount}"${style}>`+ | ||||
|            `${d.breadcrumbs}${isCloud}<span class="teaser" id="teaser_${teaserCount}" aria-label="Search Result Teaser">${teaser}</span></a>`; | ||||
|   } | ||||
| 
 | ||||
|   /* ───────────── UI control ───────────── */ | ||||
|   function showUI(s){wrap.classList.toggle('hidden',!s); icon.setAttribute('aria-expanded',s); if(s){window.scrollTo(0,0); bar.focus(); bar.select();} else {listOut.classList.add('hidden'); [...list.children].forEach(li=>li.classList.remove('focus'));}} | ||||
|   function blur(){const t=document.createElement('input'); t.style.cssText='position:absolute;opacity:0;'; icon.appendChild(t); t.focus(); t.remove();} | ||||
| 
 | ||||
|   icon.addEventListener('click',()=>showUI(wrap.classList.contains('hidden'))); | ||||
| 
 | ||||
|   document.addEventListener('keydown',e=>{ | ||||
|     if(e.altKey||e.ctrlKey||e.metaKey||e.shiftKey) return; | ||||
|     const f=/^(?:input|select|textarea)$/i.test(e.target.nodeName); | ||||
|     if(e.keyCode===HOT && !f){e.preventDefault(); showUI(true);} else if(e.keyCode===ESC){e.preventDefault(); showUI(false); blur();} | ||||
|     else if(e.keyCode===DOWN && document.activeElement===bar){e.preventDefault(); const first=list.firstElementChild; if(first){blur(); first.classList.add('focus');}} | ||||
|     else if([DOWN,UP,ENTER].includes(e.keyCode) && document.activeElement!==bar){const cur=list.querySelector('li.focus'); if(!cur) return; e.preventDefault(); if(e.keyCode===DOWN){const nxt=cur.nextElementSibling; if(nxt){cur.classList.remove('focus'); nxt.classList.add('focus');}} else if(e.keyCode===UP){const prv=cur.previousElementSibling; cur.classList.remove('focus'); if(prv){prv.classList.add('focus');} else {bar.focus();}} else {const a=cur.querySelector('a'); if(a) window.location.assign(a.href);}} | ||||
|   }); | ||||
| 
 | ||||
|   bar.addEventListener('input',e=>{ clearTimeout(debounce); debounce=setTimeout(()=>worker.postMessage(e.target.value.trim()),120); }); | ||||
| 
 | ||||
|   /* ───────────── worker messages ───────────── */ | ||||
|   worker.onmessage = ({data}) => { | ||||
|     if(data && data.ready!==undefined){ | ||||
|       if(data.ready){  | ||||
|         icon.innerHTML=READY_ICON;  | ||||
|         icon.setAttribute('aria-label','Open search (S)');  | ||||
|         icon.removeAttribute('title'); | ||||
|       } | ||||
|       else {  | ||||
|         icon.textContent='❌';  | ||||
|         icon.setAttribute('aria-label','Search unavailable');  | ||||
|         icon.setAttribute('title','Search is unavailable'); | ||||
|       } | ||||
|       return; | ||||
|    | ||||
|     const HOT=83, ESC=27, DOWN=40, UP=38, ENTER=13; | ||||
|     let debounce, teaserCount=0; | ||||
|    | ||||
|     /* ───────────── helpers (teaser, metric) ───────────── */ | ||||
|     const escapeHTML = (()=>{const M={'&':'&','<':'<','>':'>','"':'"','\'':'''};return s=>s.replace(/[&<>'"]/g,c=>M[c]);})(); | ||||
|     const URL_MARK='highlight'; | ||||
|     function metric(c,t){return c?`${c} search result${c>1?'s':''} for '${t}':`:`No search results for '${t}'.`;} | ||||
|    | ||||
|     function makeTeaser(body,terms){ | ||||
|       const stem=w=>elasticlunr.stemmer(w.toLowerCase()); | ||||
|       const T=terms.map(stem),W_S=40,W_F=8,W_N=2,WIN=30; | ||||
|       const W=[],sents=body.toLowerCase().split('. '); | ||||
|       let i=0,v=W_F,found=false; | ||||
|       sents.forEach(s=>{v=W_F; s.split(' ').forEach(w=>{ if(w){ if(T.some(t=>stem(w).startsWith(t))){v=W_S;found=true;} W.push([w,v,i]); v=W_N;} i+=w.length+1; }); i++;}); | ||||
|       if(!W.length) return body; | ||||
|       const win=Math.min(W.length,WIN); | ||||
|       const sums=[W.slice(0,win).reduce((a,[,wt])=>a+wt,0)]; | ||||
|       for(let k=1;k<=W.length-win;k++) sums[k]=sums[k-1]-W[k-1][1]+W[k+win-1][1]; | ||||
|       const best=found?sums.lastIndexOf(Math.max(...sums)):0; | ||||
|       const out=[]; i=W[best][2]; | ||||
|       for(let k=best;k<best+win;k++){const [w,wt,pos]=W[k]; if(i<pos){out.push(body.substring(i,pos)); i=pos;} if(wt===W_S) out.push('<em>'); out.push(body.substr(pos,w.length)); if(wt===W_S) out.push('</em>'); i=pos+w.length;} | ||||
|       return out.join(''); | ||||
|     } | ||||
|     const docs=data, q=bar.value.trim(), terms=q.split(/\s+/).filter(Boolean); | ||||
|     header.textContent=metric(docs.length,q); | ||||
|     clear(list); | ||||
|     docs.forEach(d=>{const li=document.createElement('li'); li.innerHTML=format(d,terms); list.appendChild(li);}); | ||||
|     listOut.classList.toggle('hidden',!docs.length); | ||||
|   }; | ||||
| })(); | ||||
| 
 | ||||
|    | ||||
|     function format(d,terms){ | ||||
|       const teaser=makeTeaser(escapeHTML(d.body),terms); | ||||
|       teaserCount++; | ||||
|       const enc=encodeURIComponent(terms.join(' ')).replace(/'/g,'%27'); | ||||
|       const parts=d.url.split('#'); if(parts.length===1) parts.push(''); | ||||
|       const abs=d.url.startsWith('http'); | ||||
|       const href=`${abs?'':path_to_root}${parts[0]}?${URL_MARK}=${enc}#${parts[1]}`; | ||||
|       const style=d.cloud?" style=\"color:#1e88e5\"":""; | ||||
|       const isCloud=d.cloud?" [Cloud]":" [Book]"; | ||||
|       return `<a href="${href}" aria-details="teaser_${teaserCount}"${style}>`+ | ||||
|              `${d.breadcrumbs}${isCloud}<span class="teaser" id="teaser_${teaserCount}" aria-label="Search Result Teaser">${teaser}</span></a>`; | ||||
|     } | ||||
|    | ||||
|     /* ───────────── UI control ───────────── */ | ||||
|     function showUI(s){wrap.classList.toggle('hidden',!s); icon.setAttribute('aria-expanded',s); if(s){window.scrollTo(0,0); bar.focus(); bar.select();} else {listOut.classList.add('hidden'); [...list.children].forEach(li=>li.classList.remove('focus'));}} | ||||
|     function blur(){const t=document.createElement('input'); t.style.cssText='position:absolute;opacity:0;'; icon.appendChild(t); t.focus(); t.remove();} | ||||
|    | ||||
|     icon.addEventListener('click',()=>showUI(wrap.classList.contains('hidden'))); | ||||
|    | ||||
|     document.addEventListener('keydown',e=>{ | ||||
|       if(e.altKey||e.ctrlKey||e.metaKey||e.shiftKey) return; | ||||
|       const f=/^(?:input|select|textarea)$/i.test(e.target.nodeName); | ||||
|       if(e.keyCode===HOT && !f){e.preventDefault(); showUI(true);} else if(e.keyCode===ESC){e.preventDefault(); showUI(false); blur();} | ||||
|       else if(e.keyCode===DOWN && document.activeElement===bar){e.preventDefault(); const first=list.firstElementChild; if(first){blur(); first.classList.add('focus');}} | ||||
|       else if([DOWN,UP,ENTER].includes(e.keyCode) && document.activeElement!==bar){const cur=list.querySelector('li.focus'); if(!cur) return; e.preventDefault(); if(e.keyCode===DOWN){const nxt=cur.nextElementSibling; if(nxt){cur.classList.remove('focus'); nxt.classList.add('focus');}} else if(e.keyCode===UP){const prv=cur.previousElementSibling; cur.classList.remove('focus'); if(prv){prv.classList.add('focus');} else {bar.focus();}} else {const a=cur.querySelector('a'); if(a) window.location.assign(a.href);}} | ||||
|     }); | ||||
|    | ||||
|     bar.addEventListener('input',e=>{ clearTimeout(debounce); debounce=setTimeout(()=>worker.postMessage({query: e.target.value.trim()}),120); }); | ||||
|    | ||||
|     /* ───────────── worker messages ───────────── */ | ||||
|     worker.onmessage = ({data}) => { | ||||
|       if(data && data.ready!==undefined){ | ||||
|         if(data.ready){  | ||||
|           icon.innerHTML=READY_ICON;  | ||||
|           icon.setAttribute('aria-label','Open search (S)');  | ||||
|           icon.removeAttribute('title'); | ||||
|         } | ||||
|         else {  | ||||
|           icon.textContent='❌';  | ||||
|           icon.setAttribute('aria-label','Search unavailable');  | ||||
|           icon.setAttribute('title','Search is unavailable'); | ||||
|         } | ||||
|         return; | ||||
|       } | ||||
|       const docs=data, q=bar.value.trim(), terms=q.split(/\s+/).filter(Boolean); | ||||
|       header.textContent=metric(docs.length,q); | ||||
|       clear(list); | ||||
|       docs.forEach(d=>{const li=document.createElement('li'); li.innerHTML=format(d,terms); list.appendChild(li);}); | ||||
|       listOut.classList.toggle('hidden',!docs.length); | ||||
|     }; | ||||
|   })(); | ||||
|    | ||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user