Files
opml-to-blogroll/README.md

70 lines
3.0 KiB
Markdown

# Opml-to-blogroll
Script en python bastante manual basado en lo que vi en el blog de [DanQ](https://danq.me/2026/01/20/blogroll-88x31s/)
Me encantan los iconitos pixelados que pone el generador de el, pero no tengo idea de donde los saca ni he visto a nadie por este ecosistema hacer uso de ellos.
Un script de Python versátil diseñado para convertir archivos de suscripciones RSS (OPML/XML) en formatos listos para publicar en la web. Ideal para crear "blogrolls" o directorios de lectura en WordPress, blogs estáticos o documentación personal.
# Descripción (Español)
Este script permite transformar tus exportaciones de FreshRSS (o cualquier lector RSS) en piezas de contenido visualmente atractivas o estructuradas.
# Funcionalidades
- Entrada Dual: Soporta archivos .opml y .xml.
- Modo Híbrido:
- Ejecución por línea de comandos para automatización.
- Interfaz Gráfica (GUI) con Tkinter para un uso sencillo.
- Formatos de Salida:
- HTML: Genera tarjetas con bordes redondeados y diseño responsivo utilizando CSS Inline (100% compatible con WordPress y otros CMS que bloquean etiquetas \<style\>).
- Markdown: Crea tablas limpias escapando caracteres especiales (como \|) para evitar errores de formato.
- JSON: Exporta una estructura de datos limpia para desarrolladores.
Portabilidad: No requiere librerías externas (solo Python 3.x).
# Uso
- **Gráfico**: Ejecuta python script.py sin argumentos.
- **Comandos**: python script.py archivo.opml -f markdown
# Description (English)
A versatile Python script designed to convert RSS subscription files (OPML/XML) into web-ready formats. Perfect for creating "blogrolls" or reading directories on WordPress, static blogs, or personal documentation.
# Features
- Dual Input: Supports both .opml and .xml files.
- Hybrid Mode:
- Command Line Interface (CLI) for automation.
- Graphical User Interface (GUI) via Tkinter for ease of use.
- Output Formats:
- HTML: Generates responsive, rounded cards using Inline CSS (100% compatible with WordPress and CMS platforms that strip \<style\> tags).
- Markdown: Creates clean tables with auto-escaping for special characters (like |) to ensure formatting stability.
- JSON: Exports a clean data structure for developers.
- Portability: Built using standard Python libraries only (Python 3.x).
# Usage
- **GUI**: Run python script.py without arguments.
- **CLI**: python script.py file.opml -f html
# Instalación / Installation
Clona este repositorio / Clone this repo:
```bash
git clone https://git.interlan.ec/Drk0027/opml-to-blogroll
```
Asegúrate de tener Python instalado / Ensure Python is installed:
```bash
python main.py
```
# Licencia / License
MIT License - Siéntete libre de usarlo y mejorarlo. / Feel free to use and improve it.
# Nota de mejora:
Este script ha sido optimizado para la compatibilidad moderna con WordPress Gutenberg y motores de renderizado de Markdown estrictos, asegurando que los enlaces y estilos se mantengan intactos independientemente de la plataforma de destino.