Knights of Ni - a GTK+ manager for your Nikola powered website
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
data
non
.gitignore
LICENSE.md
MANIFEST.in
README.md
setup.py

README.md

WHAT IS THIS?

  • a simple GTK+ tool for keeping an eye on your Nikola powered website

WHAT CAN I DO WITH IT?

  • have an overview of posts, pages, listings, images, files and translations
  • open files from app
  • keep track of changes made since last build (hint: bold)
  • create new posts and pages
  • build, preview and deploy to GitHub or GitLab or a custom target¹
  • create translation file on right click in the 'Translation' tab
  • bookmark and switch between different Nikola site instances (rudimentary feature)
  • integrated terminal for switching easily between GUI and commandline interface

¹ For deploying to GitLab the nikola github_deploy command is used. See this Example Nikola site using GitLab Pages for details on how to setup your Nikola configuration. The second "Deploy" toolbutton is active if you setup DEPLOY_COMMANDS in your conf.py and will execute the default preset.

WHAT CAN'T I DO WITH IT?

  • create a Nikola site
  • pretty much anything else, too

WHAT DO I NEED TO GET IT WORKING?

INSTALLATION

  • download and extract or clone repository and change into said folder

ARE WE THERE YET?

  • change into the non folder and execute non.py
  • if you intend to use the desktop icon, edit data/non.desktop and customize path of "Exec", and "Icon" and copy file to ~/.local/share/applications/

I'M LAZY!

  • run python setup.py install --user to install the app just for your selfish self or
  • run python setup.py install with administrator privilege for system-wide installation
  • press the SUPER key and start typing N...O...N
  • press ENTER if you spot the duck

HOW DO I GET RID OF THIS?

  • Lucky you asked. If you installed the application via setup.py, run python setup.py uninstall --user or python setup.py uninstall (with superuserpowers) to undo the installation. This will remove the Python package and any desktop files.

ANYTHING ELSE I SHOULD KNOW?

  • application related files are stored in ~/.non:
    • config.yaml for current Nikola site and bookmarks, editing or deleting does not affect any actual local Nikola site
    • non.log for the type of persons who stick their noses into everything
  • if you want to edit or delete bookmarks you have to edit the config file (.non/config.yaml)

THAT SOUNDS PRETTY BASIC. ANY PLANS FOR THE FUTURE ON THIS?

  • My view on this project is quite selfish: I'm trying to improve my skills by writing stuff I intend to use.
  • Besides this there are some ideas for further features such like
    • an integrated ReST editor
    • provide personal article templates
  • Roadmap:
    • stats on size/articles/pages/installed themes and plugins
    • give the bookmark feature some love

WHAT DOES IT LOOK LIKE?