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, translations and site statistics
- open files from app or load article in a browser on right click
- keep track of changes made since last build (hint: bold)
- create new posts and pages
- write in default reStructuredText, Markdown is also available if configured
- build, preview and deploy to GitHub or GitLab or a custom target¹
- create translation files on right click in the 'Translation' tab
- bookmark and switch between different Nikola site instances (beta feature)
¹ 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 ELSE IS THERE TO SEE?
- integrated terminal for switching easily between GUI and commandline interface
- in the 'Summary' tab there are some detailed information about the Nikola site like disk usage, available and installed themes or plugins (beta feature)
- this application is ready for localization (POT file); add your translation and open a PR if you like
WHAT CAN'T I DO WITH IT?
- create a Nikola site
- pretty much anything else, too
WHAT DO I NEED TO GET IT WORKING?
- Python 3
- Nikola installation
- latest tested versions are 7.8.15 and 8.0.0
- consult the upgrade guide for v8, this code piece cannot help you with that but also is not affected by it
- configurated Nikola site (Getting Started)
- Python GObject Introspection bindings (PyGObject)
- Python-Markdown for Python 3
- recommended: Git
PREPARING ARCHLINUX AND ITS RELATIVES
The PyGObject Introspection bindings are probably already installed (tested with a plain Openbox and Mate desktop). You can install Nikola and dependencies from the repositories, otherwise use pip (see installation on Ubuntu below):
$ sudo pacman -S nikola python-yaml
PREPARING UBUNTU 18.04 LTS
$ sudo apt-get install gir1.2-webkit2-4.0 python3-pip
Currently there is no Nikola package in the Ubuntu reposities available so you install via pip (which is the recommended install method anyway) with all dependencies included:
$ pip3 install Nikola[extras]
- download and extract or clone repository and change into said folder
FTR: when executing
pythonit is Python 3
ARE WE THERE YET?
- change into the
nonfolder and execute
- if you intend to use the desktop icon, edit
data/non.desktopand customize path of "Exec", and "Icon" and copy file to
python setup.py install --userto install the app just for your selfish self or
python setup.py installwith 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
python setup.py uninstall --useror
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
config.yamlfor current Nikola site and bookmarks, editing or deleting does not affect any actual local Nikola site
non.logfor 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 (
- the summary page is generated if a
conf.pyis loaded for the first time or invoked by the corresponding menu item because the task may take some time; it is a HTML file with GitHub flavoured css
- if you load data from a Nikola site for the first time the application indexes the content and saves it as a JSON file in the
~/.nonfolder and only updates on every next startup; this initial task may take some time depending on the size if the site - just be patient
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
- support multiple authors
- if set up using Git: pull from src to imitate cloud sync
- upgrade GUI to GTK 3.24
- give the bookmark feature some love