{"id":13697639,"url":"https://github.com/hemanta212/blogger-cli","last_synced_at":"2025-04-04T16:11:39.812Z","repository":{"id":45129310,"uuid":"169828656","full_name":"hemanta212/blogger-cli","owner":"hemanta212","description":"A cli tool to convert and manage jupyter notebook blogs. Proudly host your notebooks even as a static site. ","archived":false,"fork":false,"pushed_at":"2022-07-06T21:11:39.000Z","size":1083,"stargazers_count":417,"open_issues_count":1,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-28T15:04:33.653Z","etag":null,"topics":["blog","blogger-cli","converter","customizable","html","ipynb","jupyter","jupyter-notebooks","notebooks"],"latest_commit_sha":null,"homepage":"https://hemanta212.github.io/blogger-cli","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hemanta212.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-02-09T03:41:07.000Z","updated_at":"2025-03-22T08:19:00.000Z","dependencies_parsed_at":"2022-09-07T08:01:29.512Z","dependency_job_id":null,"html_url":"https://github.com/hemanta212/blogger-cli","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemanta212%2Fblogger-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemanta212%2Fblogger-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemanta212%2Fblogger-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hemanta212%2Fblogger-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hemanta212","download_url":"https://codeload.github.com/hemanta212/blogger-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208142,"owners_count":20901570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blog","blogger-cli","converter","customizable","html","ipynb","jupyter","jupyter-notebooks","notebooks"],"created_at":"2024-08-02T18:01:01.053Z","updated_at":"2025-04-04T16:11:39.792Z","avatar_url":"https://github.com/hemanta212.png","language":"Python","funding_links":[],"categories":["Python","Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# Blogger-cli\r\n![build](https://github.com/hemanta212/blogger-cli/workflows/Build/badge.svg)\r\n[![version](https://img.shields.io/pypi/v/blogger-cli.svg)](https://pypi.org/project/blogger-cli)\r\n[![licence](https://img.shields.io/pypi/l/blogger-cli.svg)](https://pypi.org/project/blogger-cli)\r\n[![python](https://img.shields.io/pypi/pyversions/blogger-cli.svg)](https://pypi.org/project/blogger-cli)\r\n\r\nA 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.\r\n\r\nSee a sample blog made by blogger-cli: [Here](https://pykancha.github.io/test/)\r\n\r\n## Why?\r\nIt is easy to get your hands on, works flawlessly and won't get bulky and slow over time.\r\nBlogger-cli has a simple conversion system that is fast as well as extremely customizable.\r\n\r\n\r\n## Features\r\n* Robust conversion of ipynb notebooks with great support for mobile devices as well.\r\n* Built-in support for Disqus, google analytics, navigation bar, social sharing, mathjax and code highlighting.\r\n* Support for spell checking, live server and generation of RSS/Atom feeds.\r\n* Blog management: updating the index file, parsing out images, managing topics and metadata.\r\n* Write and post blogs from android or any microdevice. All that is required is command line with python and pip.\r\n* Built-in design, blog_templates for rapidly setting up your blog from scratch.\r\n* Fully customizable with support for custom themes and templates.\r\n* Also support conversion of other file formats like markdown. You can also implement your own.\r\n\r\n\r\n## 💻 Installation\r\n\r\n### Recommended Method\r\n```\r\n$ curl -sSL https://hemanta212.github.io/blogger-cli/get_blogger.py | python\r\n```\r\nSince 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.\r\n\r\n### Using pip\r\n```\r\npip install blogger-cli\r\n```\r\n\r\nIf you mainly use jupyter notebooks, then you already have all the required dependencies although it is recommended to use `virtual environments`.\r\n\r\n\r\n## 🚀 Getting Started\r\nMake a website repository and clone it to your computer. Now register your blog name with blogger\r\n```$ blogger addblog \u003cblogname\u003e```\r\nand set up the necessary configs. Now, If you have a new site or an empty site. You can get blogger default design and boilerplate.\r\n```\r\n$ blogger export blog_layout -b \u003cblogname\u003e\r\n```\r\nNow, all assets will be moved to the blog_dir you specified in the blog config during setup.\r\n```\r\n$ blogger serve \u003cblogname\u003e\r\n```\r\nOpen the URL http://localhost:8000/ in your browser to view your blog!!\r\n\r\n## 📖 Documentation\r\n- [Installation, update, uninstall methods](docs/installation.md)\r\n- [Managing blogs and configurations](docs/blog_management.md)\r\n- [Conversion of files and folders](docs/conversion.md)\r\n- [Serving blog locally](docs/serving_blog_locally.md)\r\n- [Using export command](docs/export.md)\r\n- [Customizing templates and design](docs/customizing.md)\r\n- [Writing blog's metadata](docs/meta.md)\r\n- [Using spellcheck](docs/spellcheck.md)\r\n- [Generating feed for your blog](docs/feed.md)\r\n- [Advanced optional configurations](docs/optional_config.md)\r\n- [Recommended workflow for blogger-cli](docs/workflow.md)\r\n\r\n\u003e View docs in: [website](https://hemanta212.github.io/blogger-cli/)\r\n\r\n## Author\r\n\r\n👤 **Hemanta Sharma**\r\n- Github: [@hemanta212](https://github.com/hemanta212)\r\n\r\n## Special Thanks\r\n\r\n👤 **Nipun Batra** : Inspiration for core conversion mechanism and design resources.\r\n- Github: [@nipunbatra](https://github.com/nipunbatra)\r\n- His article on ipynb conversion: [@nipunbatra.github.io](https://nipunbatra.github.io/blog/2017/Jupyter-powered-blog.html)\r\n\r\n## Show your support\r\n\r\nPlease ⭐️ this repository if this project helped you!\r\n\r\n## 📝 License\r\nCopyright © 2019 [Hemanta Sharma](https://github.com/hemanta212).\u003cbr /\u003e\r\nThis project is [MIT](LICENSE) licensed.\r\n\r\n---\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemanta212%2Fblogger-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhemanta212%2Fblogger-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhemanta212%2Fblogger-cli/lists"}