Descripción
Jekyll is a great tool that will build a full blog site using text files written in a specific format. It gives you the bonus of having a very light and quick site that can’t be hacked through script vulnerabilities. The downside of this is that it’s not always easy to edit. It’s harder still when using a mobile device.
This is where WordPress comes in. WordPress can be used to modify the posts (both standard posts and pages) and these changes will automatically be exported. The same applies for taxonomies and users if desired. This means that it is possible to edit content using a mobile device and the WordPress app.
WordPress2Jekyll attempts to marry these two systems together in order to make a quick, secure website that can be easily managed from all devices.
What can it do?
- Exports posts and pages with all the information Jekyll needs to build a page including categories and tags.
- Convierte el contenido de la página al formato de marcado (asume que es HTML).
- Tiene la opción de usar los patrones de enlaces permanentes de WordPress en lugar de usar aquellos configurados con el método Jekyll.
- Ability to allow WordPress to run content through the_content filter to allow plugins to interact with the body content.
- Construye automáticamente páginas individuales (o construcción completa) dependiendo de lo que haya cambiado en la entrada.
- Configurable assets, data and posts directories.
- Ability to export meta data in posts.
- Export authors.
- Export taxonomies.
- On demand mass export.
Limitations
- This plugin assumes that all Jekyll posts are stored in WordPress and any files in the posts directory can be deleted. This is a necessary for maintenance.
- Featured images will be exported and linked accordingly.
- Doesn’t support password protected posts at this time (I’m not sure if it ever will).
- Doesn’t support inline media at this time.
- Supports categories (exported in order)
- Supports tags (exported in order)
- Ideally the WordPress installation should be hidden away and not publicly accessible. I’m working on a separate plugin to do this easily.
Lista de deseos
- Add full builds to a cron job.
- Export inline media.
- Modify config.yml – User selectable output options.
- Uso de CLI.
- Una configuración de página más placentera estéticamente.
Instalación
Installing this module is simple enough:
- Upload the plugin files to the
/wp-content/plugins/wp2jekyll
directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- Use the Settings->WordPress2Jekyll screen to configure the plugin. This Jekyll path must point to an existing Jekyll site directory. If you’re using it for testing purposes then make sure the assets, data and posts directories exist. It will complain if it doesn’t find them.
- Use Tools->Jekyll to perform a full export of the current content as defined in the settings.
Preguntas frecuentes
- What is Jekyll?
-
Check out https://jekyllrb.com/ It should give you all the answers you need right here.
- What do I do after the site has exported?
-
That completely depends on your setup. If you have Jekyll set up to watch the directory for changes then it will build or serve the site automatically.
Future versions will trigger Jekyll in to building the site.
- How can I use the data it exports?
-
Well the posts are self explanatory.
The taxonomy and author data is stored in as yaml files which can be used by Jekyll very easily. Check out http://jekyllrb.com/docs/datafiles/.
I personally use it to load in author information and build menus. - This is great/terrible
-
Let me know! I’d love to get some feedback on this. This is the first plugin I’ve created so go easy!
- I would really like it if it did ‘x’
-
How about you get in touch and I can see what I can do?
Colaboradores y desarrolladores
Este software es de código abierto. Las siguientes personas han contribuido a este plugin.
ColaboradoresTraduce “WordPress2Jekyll” a tu idioma.
¿Interesado en el desarrollo?
Revisa el código, echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
0.4
- Fixed an issue where the options page would error if a taxonomy wasn’t selected.
0.3
- Fixed issue relating to the default settings not being set correctly after plugin activation or upgrade.
- Fixed an issue regarding the check for Jekyll returning a false positive.
0.2.1
Fixing versioning issue.
0.2
- Se agregaron páginas de ajustes mas comprehensivas.
- Se agregó la habilidad para exportar la información meta de las entradas.
- Se agregó la habilidad de exportar usuarios. (experimental – el formato puede cambiar)
- Added ability to export taxonomies. (Experimental – format may change)
- A few bug fixes.
0.1
- Versión inicial.