reddit readme

# Reddit Thread Formatter

![Reddit Thread Formatter Logo](assets/icons/icon128.png)

## Prehľad

Reddit Thread Formatter je výkonné rozšírenie pre Chrome, ktoré transformuje Reddit diskusie na čistý, štruktúrovaný text alebo Markdown. Ideálne pre výskumníkov, tvorcov obsahu, novinárov alebo kohokoľvek, kto potrebuje archivovať, citovať alebo analyzovať Reddit diskusie v organizovanom formáte.

## Funkcie

✅ **Komplexná extrakcia vlákien**
- Zachytáva pôvodný príspevok (OP) aj s jeho textovým obsahom
- Extrahuje komentáre so zachovaním vnorenia a hierarchie diskusie
- Filtruje automatické komentáre od AutoModerator
- Podporuje staré (old.reddit.com) aj nové rozhranie Redditu

✅ **Profesionálne formátovanie**
- Možnosť výberu medzi čisto textovým formátom a Markdown
- Intuitívne vizuálne rozlíšenie úrovní komentárov pomocou odsadenia a špeciálnych znakov
- Zachovanie metadát ako skóre príspevkov, mená autorov a časové značky
- Čisté oddelenie jednotlivých sekcií pre lepšiu čitateľnosť

✅ **Moderné používateľské rozhranie**
- Prepínateľný tmavý/svetlý režim
- Jednoduché a intuitívne ovládanie
- Okamžitá vizuálna spätná väzba po akciách

✅ **Flexibilný export**
- Kopírovanie do schránky jediným kliknutím
- Stiahnutie ako Markdown súbor s názvom odvodeným od témy vlákna
- Podpora pre ďalšie spracovanie v rôznych textových alebo publikačných nástrojoch

## Ukážka výstupu

### Textový formát
```
Názov témy
===========

URL: https://old.reddit.com/r/subreddit/comments/...
Subreddit: r/example
Posted by: u/username [123 points] - 2023-01-01T12:00:00Z

Text pôvodného príspevku, ktorý môže byť aj na viacero riadkov a obsahovať
rôzne informácie. Text je čisto formátovaný bez zbytočných elementov.

--------------------------------------------------------------------------------

COMMENTS (42):

From: u/komentator1 [15 points] - 1 day ago
    Toto je prvý komentár v diskusii.

| From: u/odpoved1 [8 points] - 23 hours ago
|     Toto je odpoveď na prvý komentár.

|-- From: u/odpoved2 [3 points] - 22 hours ago
|--     Toto je druhá úroveň odpovede, zreteľne odlíšená odsadením.

From: u/komentator2 [10 points] - 20 hours ago
    Ďalší komentár prvej úrovne, začína bez odsadenia.
```

### Markdown formát
```markdown
# Názov témy

**URL:** https://old.reddit.com/r/subreddit/comments/...
**Subreddit:** r/example
**Posted by:** u/username [123 points] - 2023-01-01T12:00:00Z

Text pôvodného príspevku, ktorý môže byť aj na viacero riadkov a obsahovať
rôzne informácie. Text je čisto formátovaný bez zbytočných elementov.

---

## COMMENTS (42):

> **u/komentator1** [15 points] - *1 day ago*
> Toto je prvý komentár v diskusii.

>> **u/odpoved1** [8 points] - *23 hours ago*
>> Toto je odpoveď na prvý komentár.

>>> **u/odpoved2** [3 points] - *22 hours ago*
>>> Toto je druhá úroveň odpovede, zreteľne odlíšená odsadením.

> **u/komentator2** [10 points] - *20 hours ago*
> Ďalší komentár prvej úrovne, začína bez odsadenia.
```

## Inštalácia

### Z GitHub repozitára

1. Stiahnite alebo naklonujte tento repozitár do vášho počítača
2. Otvorte Chrome a prejdite na adresu `chrome://extensions/`
3. Zapnite "Režim pre vývojárov" v pravom hornom rohu
4. Kliknite na "Načítať rozbalené" a vyberte priečinok s rozšírením
5. Rozšírenie je teraz nainštalované a pripravené na použitie

### Z Chrome Web Store (pripravuje sa)

1. Navštívte stránku rozšírenia v Chrome Web Store
2. Kliknite na "Pridať do Chromu"
3. Potvrďte inštaláciu v dialógovom okne
4. Rozšírenie sa automaticky pridá do prehliadača

## Použitie

1. Navštívte akúkoľvek diskusiu (vlákno) na Reddite
2. Kliknite na ikonu Reddit Thread Formatter v lište nástrojov prehliadača
3. Vyberte požadovaný formát výstupu (čistý text alebo Markdown)
4. Kliknite na "Formátovať aktuálne vlákno" na spracovanie diskusie
5. Formátovaný text sa zobrazí v textovom poli
6. Použite tlačidlo "Kopírovať do schránky" na skopírovanie textu alebo "Stiahnuť md" na uloženie ako súbor

## Riešenie problémov

- **Rozšírenie nemôže komunikovať so stránkou**: Skúste stránku obnoviť (F5) a znova kliknúť na ikonu rozšírenia
- **Formátovanie nezachytilo celý obsah**: Uistite sa, že ste na stránke s konkrétnym príspevkom, nie na zozname príspevkov
- **Problémy s old.reddit.com**: Skontrolujte, či ste na stránke konkrétneho vlákna s viditeľnými komentármi

## Štruktúra projektu

```
reddit-thread-formatter/
├── manifest.json         # Konfigurácia rozšírenia pre Chrome
├── popup/                # Používateľské rozhranie rozšírenia
│   ├── popup.html        # HTML štruktúra rozhrania
│   ├── popup.css         # Štýly rozhrania
│   └── popup.js          # Logika interakcie s používateľom
├── scripts/              # Hlavné skripty rozšírenia
│   ├── content.js        # Komunikácia so stránkou Reddit
│   ├── parser.js         # Parsovanie údajov z vlákien
│   └── formatter.js      # Formátovanie údajov do čitateľného textu
├── background/           # Skripty na pozadí
│   └── background.js     # Správa udalostí prehliadača
└── assets/               # Statické súbory
    └── icons/            # Ikony rozšírenia
```

## Vývoj

### Predpoklady

- Prehliadač Chrome alebo Edge
- Základná znalosť HTML, CSS a JavaScript
- Porozumenie štruktúry stránok Reddit (starých aj nových)

### Lokálny vývoj

1. Vykonajte zmeny v zdrojovom kóde
2. Načítajte alebo znova načítajte rozšírenie na stránke s rozšíreniami Chrome
3. Testujte funkcionalitu na rôznych Reddit diskusiách
4. Využite konzolu prehliadača (F12) na zobrazenie logov a ladenie

### Testovanie

Rozšírenie bolo testované na rôznych typoch Reddit vlákien vrátane:
- Diskusie s hlboko vnorenými komentármi
- Príspevky s dlhým textovým obsahom
- Vlákna s vymazanými komentármi a profilmi používateľov
- Príspevky s rôznym vzhľadom na old.reddit.com a novom Reddite

## Pripravované funkcie

- Možnosť filtrovať komentáre podľa skóre
- Možnosť obmedziť maximálnu hĺbku vnorenia komentárov
- Export do viacerých formátov (HTML, JSON)
- Automatické zachytávanie obrázkov a odkazov z príspevkov
- Rozšírené možnosti formátovania a prispôsobenia výstupu

## Licencia

Toto rozšírenie je k dispozícii pod licenciou MIT. Pozrite si súbor LICENSE pre podrobnosti.

## Poďakovanie

- Vytvorené pre komunitu Reddit, špeciálne pre používateľov, ktorí potrebujú čistý a formátovaný obsah diskusií
- Navrhnuté s dôrazom na funkčnosť pri oboch rozhraniach Redditu (starom aj novom)
- Inšpirované spätnou väzbou od tvorcov obsahu, výskumníkov a nadšencov Redditu