Noteworthy | A PHP-Based Blogging Tool for Evernote
Pull request Compare This branch is 28 commits behind matigo:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
conf
lang
lib
sql
themes
.gitignore
.htaccess
README.md
index.php
robots.txt

README.md

Noteworthy

A PHP-Based Blogging Tool for use with Evernote

The Following is a list of notes regarding the use and configuration of Noteworthy.

General Requirements

You will need:

  • a web server running PHP 5.0 or higher
  • MySQL 5.0 or higher

Optional Components

There are some optional pieces to the puzzle that might make things a little better. These things include:

  • something to drink
  • good music
  • a faithful dog

Installation

Installation is pretty straight-forward, as Noteworthy will do all of the work. You don't need to mess around with text files or anything like that. It's all controlled through the web administration panels. And here's the Order of Operations:

  1. Dump all the files into a directory
  2. Make sure all directories (including the web root) are 755
  3. Visit the website just to make sure it's working
  4. Pet your dog
  5. Visit {Website}/install/
  6. Enter your email address (A real one is not important. This isn't for me. It's for you.)
  7. Configure Noteworthy using the "Sites" and "Settings" tabs
  8. Let Noteworthy download the Evernote notebooks you've selected

Disclaimers

Do NOT share your Evernote API keys with anybody. You have been warned.

If you are using a shared hosting platform, you will probably want to create three other directories before visiting Noteworthy for the first time:

  • /logs
  • /tokens
  • /users

I've seen on two different shared hosting servers problems when Noteworthy creates the directories that it needs for your data. The issue seems to be with write permission to the new directories after they've been created. If you have shell access to your account, then it's not a problem. Make all directories (including the web root) 755 [chmod -R 755], and you'll be good.

And finally ...

Don't lose your admin URL. Unlike most other blogging platforms, Noteworthy does not have a static administration URL. It's unique for every person. If you lose your login, you will need to do some ugly workarounds in the filesystem in order to regain permission to the admin panel. This will be addressed in later releases.

Considerations

The use of a database is a requirement at the moment. In future releases, the MySQL component will be optional.

Quick Notes

Noteworthy will create any missing directories that it needs, so please ensure the files and directories are owned by Apache (or whichever user is the web server). No directory should be 777. 755 is plenty sufficient for this project.

Questions?

Have questions about Noteworthy? Feel free to contact me on here, Twitter, or my website. I respond to all email.