Skip to main content

Blogger cli is a CLI tool to convert ipynb, md, html file to responsive html files.

Project description

Blogger-cli

build version licence python

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 a blog post with mathjax, code support, google analytics, navigation, Disqus support.

See a sample blog made by blogger-cli: Here

Why?

It is easy to get your hands on, works flawlessly and won't get bulky and slow over time. Blogger-cli has a simple conversion system that is fast as well as extremely customizable.

Features

  • Robust conversion of ipynb notebooks with great support for mobile devices as well.
  • Built-in support for Disqus, google analytics, navigation bar, social sharing, mathjax and code highlighting.
  • Support for spell checking, live server and generation of RSS/Atom feeds.
  • Blog management: updating the index file, parsing out images, managing topics and metadata.
  • Write and post blogs from android or any microdevice. 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.

💻 Installation

Recommended Method

$ curl -sSL https://hemanta212.github.io/blogger-cli/get_blogger.py | python

Since blogger has a lot of dependencies (nbconvert, jupyter), this custom installer will install them in a virtual environment and add it to your path for global access.

Using pip

pip install blogger-cli

If you mainly use jupyter notebooks, then you already have all the required dependencies although it is recommended to use virtual environments.

🚀 Getting Started

Make a website repository and clone it to your computer. Now register your blog name with blogger $ blogger addblog <blogname> and set up the necessary configs. Now, If you have a new site or an empty site. You can get blogger default design and boilerplate.

$ 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!!

📖 Documentation

View docs in: website

Author

👤 Hemanta Sharma

Special Thanks

👤 Nipun Batra : Inspiration for core conversion mechanism and design resources.

Show your support

Please ⭐️ this repository if this project helped you!

📝 License

Copyright © 2019 Hemanta Sharma.
This project is MIT licensed.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

blogger-cli-1.2.4.tar.gz (89.6 kB view hashes)

Uploaded Source

Built Distribution

blogger_cli-1.2.4-py3-none-any.whl (117.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page