A custom cli tool to process jupyter notebooks, markdown files and html files. Write your blog in markdown or jupyter notebooks and then transform into blog post with mathjax, code support, google analytics, navigation, disqus support.
See a sample blog made by blogger-cli: Here
It is easy to get your hands on, works flawlessly and won't get bulky and slow overtime. Blogger-cli has simple conversion system that is fast as well extremely customizable.
- Robust conversion of ipynb notebooks with great support for mobile devices as well.
- Built in support for disqus, google analytics, navigation bar, mathjax and code highlighting.
- Blog management: updating index, parsing out images, managing topics and metadata.
- Write and post blogs from android or any micro device. All that is required is command line with python and pip.
- Built in design, blog_templates for rapidly setting up your blog from scratch.
- Fully customizable with support for custom themes and templates
- Also support conversion of other file formats like markdown. You can also implement your own.
$ curl -sSL https://hemanta212.github.io/blogger-cli/get_blogger.py | python
Since blogger has alot of dependecies (nbconvert, jupyter), this custom installer will install in a virtualenv and add it to your path for global access!.
pip install blogger-cli
If you mainly use jupyter notebook, then you already have all dependecies although it is recommende to use virutalenv.
Make a website repository and clone it to your computer. Now register your blogname with blogger
$ blogger addblog <blogname>
and setup necessary configs. Now, If you have new site or empty site. You can get blogger default design and boiler plate.
$ blogger export blog_layout -b <blogname>
Now, all assets will be moved to the blog_dir you specified in the blog config during setup.
$ blogger serve <blogname>
Open the url http://localhost:8000/ in your browser to view your blog!!
- Installation, update, uninstall methods
- Managing blogs and configurations
- Conversion of files and folders
- Serving blog locally
- Using export command
- Customizing templates and design
- Writing blog's metadata
- Recommended workflow for blogger-cli
View docs in: website
π€ Hemanta Sharma
- Github: @hemanta212
π€ Nipun Batra : Inspiration for core conversion mechanism and design resources.
- Github: @nipunbatra
- His article on ipynb conversion: @nipunbatra.github.io
Please βοΈ this repository if this project helped you!