¿Cómo instalar bridgetown-svg-inliner en Bridgetown?

Es más sencillo de lo que parece.

La tarea es sencilla si has usado Ruby on Rails, ya que el proceso es idéntico a instalar gemas en un Gemfile. Te detallo los pasos:

NOTA: Existe otra gema llamada bridgetown-inline-svg pero está en modo de mantenimiento, por lo que no se recomienda su uso.

La gema recomendada es bridgetown-svg-inliner, que tiene compatibilidad con la última versión de Bridgetown y licencia MIT.

• Agrega la gema a tu Gemfile

group :bridgetown_plugins do
  gem "bridgetown-svg-inliner"
end

• Ejecuta bundle install en la terminal.

  # En la carpeta principal del proyecto
  bundle install

• Listo. Ya puedes usar archivos SVG desde una etiqueta SVG:

<!-- formato liquid -->
{% svg "images/github.svg" %}

# formato erb
<%= svg "images/youtube.svg" %>

NOTA: Si copias el código anterior, elimina los comentarios.

• No es necesario usar la ruta completa desde la raíz del proyecto, basta con la ruta relativa a la carpeta de imágenes que Bridgetown proporciona por defecto en:

proyecto/src/images

Para más información, revisa el README de la gema.