WordPress to Jekyll Konvertáló

Ez a Python szkript segít WordPress exportált XML tartalom Jekyll-kompatibilis markdown fájlokká való konvertálásában. A szkript feldolgozza a WordPress exportált bejegyzéseit, és kategóriánként rendezett, megfelelően formázott markdown fájlokat hoz létre.

Funkciók

• WordPress exportált XML fájlok feldolgozása
• Jekyll-kompatibilis markdown formátum létrehozása
• Bejegyzések rendezése kategóriánként (opcionális)
• Automatikus URL-barát slug generálás
• YAML frontmatter létrehozása megfelelő metaadatokkal
• Bejegyzések tartalma az eredeti formátumban kerül átmásolásra
• Csak a publikált bejegyzések kerülnek átkonvertálásra

Telepítés

A szkript futtatásához Python 3.6 vagy újabb verzió szükséges. Külső függőségeket nem igényel.

git clone https://github.com/felhasznaloneved/wordpress-to-jekyll.git
cd wordpress-to-jekyll

Használat

WordPress XML exportálása

Mielőtt elkezdenéd, exportáld a WordPress tartalmadat:

1. Jelentkezz be a WordPress admin felületére
2. Navigálj: Eszközök > Exportálás
3. Válaszd a "Bejegyzések" opciót
4. Kattints az "Exportálás letöltése" gombra
5. Mentsd el az XML fájlt

A szkript futtatása

python wp_to_jekyll.py wordpress-export.xml

Parancssori argumentumok

usage: wp_to_jekyll.py [-h] [--output OUTPUT] [--by-category] xml_file

WordPress export fájlból Jekyll markdown fájlok generálása

positional arguments:
  xml_file              WordPress export XML fájl elérési útja

optional arguments:
  -h, --help            show this help message and exit
  --output OUTPUT, -o OUTPUT
                        Kimeneti mappa elérési útja (alapértelmezés: _posts)
  --by-category, -c     Bejegyzések rendezése kategóriánként

Példák

Alapértelmezett használat:

python wp_to_jekyll.py wordpress-export.xml

Ez létrehoz egy _posts mappát és ide menti a markdown fájlokat.

Egyéni kimenet megadása:

python wp_to_jekyll.py wordpress-export.xml --output ./jekyll-tartalom

Bejegyzések rendezése kategóriánként:

python wp_to_jekyll.py wordpress-export.xml --by-category

Ebben az esetben a szkript a kategórianeveknek megfelelő almappákat hoz létre a kimeneti mappában, és a bejegyzéseket ezekbe rendezi.

Kimenet formátuma

A generált markdown fájlok a következő formátumúak lesznek:

---
layout: post
title: "Bejegyzés címe"
date: 2023-03-14
categories: 
  - kategoria-neve
---

link: https://eredeti-wordpress-oldal.hu/bejegyzes-url

Bejegyzés tartalma...

Hibaelhárítás

• Karakterkódolási problémák: Ha a kimeneti fájlokban furcsa karakterek jelennek meg, ellenőrizd, hogy az XML fájlod megfelelően van-e kódolva (UTF-8 ajánlott).
• Ékezetes karakterek: A szkript automatikusan eltávolítja az ékezeteket a fájlnevekből és slug-okból, de megőrzi a tartalomban.
• Hiányzó tartalom: Ha egyes bejegyzések hiányoznak, ellenőrizd, hogy publikált állapotban vannak-e, és a post típusuk megfelelő-e.

Jekyll használata a konvertált tartalommal

A konvertált fájlokat egyszerűen bemásolhatod egy Jekyll projekt _posts mappájába, vagy a kategóriáknak megfelelő almappákba. Jekyll automatikusan felismeri és feldolgozza ezeket.

Licenc

Ez a projekt a GNU General Public License v3.0 alatt áll.

---

Közreműködés

Ha hibát találsz, vagy fejlesztési javaslatod van, kérlek nyiss egy issue-t vagy küldj egy pull request-et!