flex/README.md

88 lines
3.8 KiB
Markdown
Raw Normal View History

2016-08-11 22:07:48 +02:00
# Flex [![Build Status](https://travis-ci.org/alexandrevicenzi/Flex.svg?branch=master)](https://travis-ci.org/alexandrevicenzi/Flex) [![Dependency Status](https://david-dm.org/alexandrevicenzi/Flex.svg)](https://david-dm.org/alexandrevicenzi/Flex) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/alexandre-vicenzi/flex?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
2015-07-19 02:04:01 +02:00
2016-08-25 04:39:12 +02:00
The minimalist [Pelican](http://blog.getpelican.com/) theme.
2015-07-19 02:04:01 +02:00
2018-06-24 06:55:49 +02:00
## Notes
2017-02-20 20:01:05 +01:00
2018-06-24 06:55:49 +02:00
- **DO NOT** send any questions to my personal email, they are **IGNORED**. If you have questions open an issue.
- This theme is not under development anymore, it's stable and has a lot of features. This means that new requests (not bug fixes) will be discussed and have lower priorities.
- If you want a version of this theme to Jekyll or Hugo open an issue and let's discuss it.
2017-02-20 20:01:05 +01:00
2015-07-19 02:04:01 +02:00
## Features
- Mobile First
- Responsive
- Semantic
2015-07-19 02:22:29 +02:00
- SEO Best Practices
2015-07-20 04:34:54 +02:00
- Open Graph
- Rich Snippets (JSON-LD)
2017-03-14 05:17:17 +01:00
- Related Posts (via [plugin](https://github.com/getpelican/pelican-plugins/tree/master/related_posts) or AddThis)
2017-03-14 04:47:35 +01:00
- Minute read (via [plugin](https://github.com/getpelican/pelican-plugins/tree/master/post_stats)) (new in 2.0)
- [Multiple Code Highlight Styles](https://github.com/alexandrevicenzi/Flex/wiki/Code-Highlight)
- [Translation Support](https://github.com/alexandrevicenzi/Flex/wiki/Translations) (new in 2.0)
2015-07-19 02:04:01 +02:00
## Integrations
2017-03-14 05:17:17 +01:00
- [AddThis](http://www.addthis.com/) Share Buttons and Related Posts
2015-11-25 02:54:18 +01:00
- [Disqus](https://disqus.com/)
2017-04-22 08:41:39 +02:00
- [Gauges Analytics](http://get.gaug.es/)
2018-06-24 06:55:49 +02:00
- [Google AdSense](https://www.google.com.br/adsense/start/) (new in 2.1.0)
2015-11-25 02:54:18 +01:00
- [Google Analytics](https://www.google.com/analytics/web/)
- [Google Tag Manager](https://www.google.com/tagmanager/)
2017-04-22 08:41:39 +02:00
- [Piwik Analytics](http://piwik.org/)
2015-11-25 02:54:18 +01:00
- [StatusCake](https://www.statuscake.com/)
2017-03-14 05:17:17 +01:00
## Plugins Support
2018-06-24 06:55:49 +02:00
- [Github Corners](https://github.com/tholman/github-corners) (new in 2.2.0)
2017-03-14 05:17:17 +01:00
- [I18N Sub-sites](https://github.com/getpelican/pelican-plugins/tree/master/i18n_subsites) (new in 2.0)
2018-01-13 04:52:52 +01:00
- [Minute read](https://github.com/getpelican/pelican-plugins/tree/master/post_stats) (new in 2.0)
2017-03-14 05:17:17 +01:00
- [Related Posts](https://github.com/getpelican/pelican-plugins/tree/master/related_posts)
2018-06-24 06:55:49 +02:00
- [Representative image](https://github.com/getpelican/pelican-plugins/tree/master/representative_image) (new in 2.2.0)
- [Neighbors](https://github.com/getpelican/pelican-plugins/tree/master/neighbors) (new in 2.2.0)
2015-07-19 02:04:01 +02:00
2016-04-24 00:44:16 +02:00
## Install
2018-06-24 06:55:49 +02:00
The best way to install is over [pelican-themes](https://github.com/getpelican/pelican-themes).
2016-04-24 00:44:16 +02:00
2018-06-24 06:55:49 +02:00
The alternative way is to clone this repository. The `master` branch is stable and is safe to checkout, but I would recommend you to checkout a tag branch.
2016-04-24 00:44:16 +02:00
2017-03-14 04:23:49 +01:00
## Donate
2017-07-13 04:22:43 +02:00
Are you using this theme? Support bug fixes and new features.
2017-03-14 04:23:49 +01:00
2018-02-27 03:25:14 +01:00
[Click here](https://www.alexandrevicenzi.com/donate) to donate.
2017-03-14 04:23:49 +01:00
2018-06-24 06:55:49 +02:00
## Documentation
The documentation covers most of the settings available and how to use this theme.
If something is missing or broken you can open a PR or fix the documentation by yourself.
[Flex Wiki](https://github.com/alexandrevicenzi/Flex/wiki)
2017-07-13 04:22:43 +02:00
## Live example
2018-01-13 04:52:52 +01:00
You can see how this theme looks like at [http://flex.alxd.me/blog/](http://flex.alxd.me/blog/).
2017-07-13 04:22:43 +02:00
2018-06-24 06:55:49 +02:00
The code is available in this project under `docs` folder.
## Contributing
**ALWAYS** open an issue before sending a PR.
Discuss the problem/feature that you want to code.
After discussing, send a PR with your changes.
As always, if you want something that only makes sense to you, fork Flex and create a new theme.
2017-03-14 04:23:49 +01:00
2018-06-24 06:55:49 +02:00
## Translations
2016-08-25 04:39:12 +02:00
Translate this theme to new languages at [Transifex](https://www.transifex.com/alexandrevicenzi/flex-pelican/).
2018-06-24 03:54:37 +02:00
![Translations](https://github.com/alexandrevicenzi/Flex/blob/master/translations/translation_chart.png)
2016-08-25 04:39:12 +02:00
2018-06-24 06:55:49 +02:00
Read more about [Translation Support](https://github.com/alexandrevicenzi/Flex/wiki/Translations) in the Wiki.
2016-08-25 04:39:12 +02:00
2015-07-19 02:04:01 +02:00
## License
MIT