Package: jekyll-manager
jekyll-managerWhat is jekyll-manager?Jekyll-Manager is a command-line tool that acts as an interface to manage your jekyll blog.Currently, the extent of the tool covers managing posts (listing, viewing, editing, creating and deleting),
but plans to cover more. Your suggestions are always welcome!QuickStart (Method One: with pip)Jekyll-Manager is available for download via pip (pagehere).To download, you simply need to run:pip install jekyll-managerHow to runIf you installed it via pip, then it's quite easy to run.There are 3 ways (currently) to run the program:Type injekyll-manager </relative/path/to/jekyll-blog>to manage your blog.Traverse to the root of your jekyll blog directory, then type injekyll-managerto manage your blog.Set the environement variableJEKYLL_ROOTto point to your jekyll blog directory, and runjekyll-managerfrom anywhere.Jekyll-Manager will find your blog in the order above, so even if you're in a jekyll-blog directory, and
type in the path to another directory, it'll check that other directory.Method Two: setup.pyAlternatively, if you don't want to download via pip, clone the repository by typing inuser@computer:~/Downloads/$ git clone https://github.com/kludron/jekyll-managerThen traverse into the directory and run thepython setup.py installuser@computer:~/Downloads/$ cd jekyll-manager
user@computer:~/Downloads/jekyll-manager/$ python setup.py installYou should now be able to follow the same instructions as in the 'How to run' section!Build it yourselfWith the current build being in Python3, this needs to be installed.Installation guide for Python3 can be foundhere.https://www.python.org/downloads/After installing Python3, we need to install all of the required packages. To do this,pipneeds to be
installed. If this is not already installed, installation steps can be foundhere.https://pip.pypa.io/en/stable/installation/To install the required packages, first you will need to clone the repository. To do this, open your
terminal (or command prompt on windows) and type in:user@computer:~/Downloads/$ git clone https://github.com/kludron/jekyll-managerThe next step is to install the required pip packages. To do this, type in:user@computer:~/Downloads/$ cd jekyll-manager
user@computer:~/Downloads/jekyll-manager/$ pip install -r requirements.txtHow to run (build it yourself)Now that the requirements are installed, jekyll-manager can be run directlyNOTE: This is tool is currently not yet configured to be run directly for Windows Machines. Thepythonprefix is needed./jekyll-manager <jekyll-blog-directory>or with pythonpython jekyll-manager <jekyll-blog-directory>There is also the ability to run this program from anywhere (by setting environment variables).Linux / MacOSFor Linux and MacOS users, this can be done by symlinking the file to your local bin folder.NOTE: For this to work, your $HOME/.local/bin file needs to be in your PATH.ln -s $(pwd)/jekyll-manager $HOME/.local/bin/WindowsFor Windows users, this can be done by adding the jekyll-manager folder to your path. To do this:NOTE: Currently, this is unsupported and not available on Windows machines yet.Open up Control Panel.Type inenvin the search bar.Click on 'Edit environment variable for you account'.Select the 'Variable' named 'PATH'.Click on 'Edit...'Click on 'New'Type in the Path to the jekyll-manager folder (that was cloned from github).Click OKClick OK (again)Restart your device (for changes to take effect)After adding it to your path, you can follow the guide in the (first) 'How to run' section.FAQMy Jekyll Configuration is different to the default, can I still use this tool?Not at the moment.This tool is still very much in progress, but will cater towards all configurations for jekyll in the
near future. Stay tuned!