⚡️ refactor: co-locate images (#200)

content/projects/spectro/index.ca.md

@@ -0,0 +1,77 @@
++++
+title = "spectro"
+description = "Script en Bash per generar espectrogrames, comparar-los, pujar-los a Imgur i proporcionar les URL corresponents per compartir."
+weight = 4
+
+[extra]
+local_image = "projects/spectro/spectro.webp"
+canonical_url = "https://osc.garden/ca/projects/spectro/"
+social_media_card = "social_cards/ca_projects_spectro.jpg"
++++
+
+Transforma fitxers d'àudio en espectrogrames amb format BBCode de manera senzilla amb `spectro`. Aquest script en Bash suporta una àmplia varietat de formats d'àudio com Ogg, MP3, FLAC, AAC i més.
+
+{{ full_width_image(src="projects/spectro/spectrogram.webp", alt="Espectrograma de Jardin du Sommeil Chant d'Amour Sur La Nuit Grandissante, de Tourette") }}
+
+#### [Veure a GitHub](https://github.com/welpo/spectro) {.centered-text}
+
+## Característiques
+
+- **Suport de múltiples formats**: Ogg, MP3, FLAC, AAC, ape, WMA, MP4 i WAV.
+- **Sortida en BBCode**: Genera automàticament BBCode per a fòrums o llocs web.
+- **Processament per lots**: Pot gestionar directoris sencers o fitxers específics.
+- **Extensible**: Opcions per a personalització, incloent l'emmagatzemament local i la pujada a Imgur.
+
+## Inici ràpid
+
+1. Descarrega `spectro` en un directori dins del teu PATH, per exemple, `~/bin`.
+2. Atorga permisos d'execució: `chmod +x spectro`.
+
+## Ús
+
+**Generar BBCode per a un directori complet:**
+
+```bash
+spectro Path/To/Directory/
+```
+
+Sortida:
+
+```
+[hide=Spectrograms][size=3]
+[url=https://i.imgur.com/ClzzbP8.png]01. Jardin Du Sommeil.flac[/url]
+[/size][/hide]
+```
+
+**Generar BBCode per a fitxers específics:**
+
+```bash
+spectro arxiu1.flac arxiu2.mp3
+```
+
+Opcions addicionals i configuracions estan disponibles. Consulta `spectro --help`:
+
+{% wide_container() %}
+
+```
+Usage: spectro [options] <audio_files>
+Generate BBCode-formatted spectrograms from audio files.
+
+Options:
+    -c, --compare     Create a .gif comparison of spectrograms (requires ImageMagick)
+    -d, --double      Create both zoomed and full spectrograms
+    -h, --help        Display this help and exit
+    -l, --local       Save spectrograms locally
+    -o, --optipng     Reverse optipng setting
+    -p, --parallel    Compatible with 'parallel'
+    -q, --quiet       Suppress 'Uploading' text
+    -s, --sha         Display SHA value
+    -t, --text        Use [url] or [img] tags
+    -z, --zoom        Create zoomed-in spectrogram
+
+Examples:
+    spectro -ol DirectoryWithMusic/
+    printf "[hide=Spectrograms][size=3]" && ls | parallel -k spectro -p; printf "[/size][/hide]"
+```
+
+{% end %}

content/projects/spectro/index.es.md

@@ -0,0 +1,79 @@
++++
+title = "spectro"
+description = "Script en Bash para generar espectrogramas, compararlos, subirlos a Imgur y proporcionar las URL correspondientes para compartir."
+weight = 4
+
+[extra]
+local_image = "projects/spectro/spectro.webp"
+canonical_url = "https://osc.garden/es/projects/spectro/"
+social_media_card = "social_cards/es_projects_spectro.jpg"
++++
+
+Transforma archivos de audio en espectrogramas con formato BBCode de manera sencilla con `spectro`. Este script en Bash soporta una amplia variedad de formatos de audio como Ogg, MP3, FLAC, AAC y más.
+
+{{ full_width_image(src="projects/spectro/spectrogram.webp", alt="Espectrograma de Jardin du Sommeil Chant d'Amour Sur La Nuit Grandissante, de Tourette") }}
+
+#### [Ver en GitHub](https://github.com/welpo/spectro) {.centered-text}
+
+## Características
+
+- **Soporte de múltiples formatos**: Ogg, MP3, FLAC, AAC, ape, WMA, MP4 y WAV.
+- **Salida en BBCode**: Genera automáticamente BBCode para foros o sitios web.
+- **Procesamiento por lotes**: Puede manejar directorios enteros o archivos específicos.
+- **Extensible**: Opciones para personalización, incluido el almacenamiento local y la subida a Imgur.
+
+## Inicio rápido
+
+1. Descarga `spectro` en un directorio dentro de tu PATH, por ejemplo, `~/bin`.
+2. Otorga permisos de ejecución: `chmod +x spectro`.
+
+Para una guía completa de instalación, [lee la documentación completa](https://github.com/welpo/spectro#install).
+
+## Uso
+
+**Generar BBCode para un directorio completo:**
+
+```bash
+spectro Path/To/Directory/
+```
+
+Salida:
+
+```
+[hide=Spectrograms][size=3]
+[url=https://i.imgur.com/ClzzbP8.png]01. Jardin Du Sommeil.flac[/url]
+[/size][/hide]
+```
+
+**Generar BBCode para archivos específicos:**
+
+```bash
+spectro archivo1.flac archivo2.mp3
+```
+
+Opciones adicionales y configuraciones están disponibles. Consulta `spectro --help`:
+
+{% wide_container() %}
+
+```
+Usage: spectro [options] <audio_files>
+Generate BBCode-formatted spectrograms from audio files.
+
+Options:
+    -c, --compare     Create a .gif comparison of spectrograms (requires ImageMagick)
+    -d, --double      Create both zoomed and full spectrograms
+    -h, --help        Display this help and exit
+    -l, --local       Save spectrograms locally
+    -o, --optipng     Reverse optipng setting
+    -p, --parallel    Compatible with 'parallel'
+    -q, --quiet       Suppress 'Uploading' text
+    -s, --sha         Display SHA value
+    -t, --text        Use [url] or [img] tags
+    -z, --zoom        Create zoomed-in spectrogram
+
+Examples:
+    spectro -ol DirectoryWithMusic/
+    printf "[hide=Spectrograms][size=3]" && ls | parallel -k spectro -p; printf "[/size][/hide]"
+```
+
+{% end %}

content/projects/spectro/index.md

@@ -0,0 +1,79 @@
++++
+title = "spectro"
+description = "Bash script to generate spectrograms, compare them, upload them to Imgur, and provide the corresponding URLs for sharing."
+weight = 4
+
+[extra]
+local_image = "projects/spectro/spectro.webp"
+canonical_url = "https://osc.garden/projects/spectro/"
+social_media_card = "social_cards/projects_spectro.jpg"
++++
+
+Transform audio files into BBCode-formatted spectrograms effortlessly with `spectro`. This Bash script supports a wide array of audio formats such as Ogg, MP3, FLAC, AAC, and more.
+
+{{ full_width_image(src="projects/spectro/spectrogram.webp", alt="Spectrogram of Jardin du Sommeil Chant d'Amour Sur La Nuit Grandissante, by Tourette") }}
+
+#### [View on GitHub](https://github.com/welpo/spectro) {.centered-text}
+
+## Features
+
+- **Versatile Format Support**: Ogg, MP3, FLAC, AAC, ape, WMA, MP4, and WAV.
+- **BBCode Output**: Automatically generates BBCode for forums or websites.
+- **Batch Processing**: Can handle entire directories or specific files.
+- **Extensible**: Options for customisation including local storage and imgur uploading.
+
+## Quick Start
+
+1. Download `spectro` to a directory within your PATH, for example, `~/bin`.
+2. Grant execute permissions: `chmod +x spectro`.
+
+For a complete installation guide, [read the full documentation](https://github.com/welpo/spectro#install).
+
+## Usage
+
+**Generate BBCode for an Entire Directory:**
+
+```bash
+spectro Path/To/Directory/
+```
+
+Output:
+
+```
+[hide=Spectrograms][size=3]
+[url=https://i.imgur.com/ClzzbP8.png]01. Jardin Du Sommeil.flac[/url]
+[/size][/hide]
+```
+
+**Generate BBCode for Specific Files:**
+
+```bash
+spectro file1.flac file2.mp3
+```
+
+Additional options and configurations are available. See `spectro --help`:
+
+{% wide_container() %}
+
+```
+Usage: spectro [options] <audio_files>
+Generate BBCode-formatted spectrograms from audio files.
+
+Options:
+    -c, --compare     Create a .gif comparison of spectrograms (requires ImageMagick)
+    -d, --double      Create both zoomed and full spectrograms
+    -h, --help        Display this help and exit
+    -l, --local       Save spectrograms locally
+    -o, --optipng     Reverse optipng setting
+    -p, --parallel    Compatible with 'parallel'
+    -q, --quiet       Suppress 'Uploading' text
+    -s, --sha         Display SHA value
+    -t, --text        Use [url] or [img] tags
+    -z, --zoom        Create zoomed-in spectrogram
+
+Examples:
+    spectro -ol DirectoryWithMusic/
+    printf "[hide=Spectrograms][size=3]" && ls | parallel -k spectro -p; printf "[/size][/hide]"
+```
+
+{% end %}