Skip to content

Latest commit

 

History

History
207 lines (143 loc) · 7.45 KB

README.md

File metadata and controls

207 lines (143 loc) · 7.45 KB
Raw

Laverna Revisited - note taking web app revisited

Demo: To test a demo of Laverna Revisited, go to http://qrest.github.io/static-laverna

This is my take on Laverna, a note-taking app. I modified it for usability, visibility, and maximizing screen real-estate. Some changes are:

  • Edit-first workflow
  • Save button doesn't bring you back to Show view
  • Delete and View buttons in Edit view
  • Page-style edit container
  • View button in sidebar item
  • Sidebar buttons only appear on hover
  • Curved edges on menu items
  • Roboto and Office Code Pro fonts in Edit view

Right now it's in initial phases and hacked together in places. There exist some small bugs, but it's very usable right now. I'll release it as V1.0 once it's to a point where I think it's mostly done.

Some features I would love to add:

  • Emoji picker in button pane - Since emojis work fine in text already
  • Clickable links in Edit view

Note: No plans to PR right now because this is purely an exercise for me, but I would like for features I've included to make it to the upstream, because I feel the original app is great but unusable for real note-taking. My fork aims to fix that!

About Laverna

Join the chat at https://gitter.im/Laverna/laverna

Build Status devDependency Status Code Climate

Laverna is a JavaScript note-taking web application with a Markdown editor and encryption support. It's built to be an open source alternative to Evernote.

The application stores all your notes in your browser databases such as indexedDB or localStorage, which is good for security reasons, because only you have access to them.

Demo: https://laverna.cc/ OR http://laverna.github.io/static-laverna

Features

  • Markdown editor based on Pagedown
  • Manage your notes, even when you're offline
  • Secure client-side encryption
  • Synchronizes with cloud storage services (currently only with Dropbox and RemoteStorage)
  • Three editing modes: distraction free, preview, and normal mode
  • WYSIWYG control buttons
  • MathJax support
  • Syntax highlighting
  • No registration required
  • Web based
  • Keybindings

Tools

On the front-end this project uses JavaScript and the Marionette JS framework while Node JS, Bower, and Gulp.js are used on the back-end. The test runner used is karma however, contributors are free to utilize whatever testing tools they desire.

Installation

There are several ways to start using Laverna:

  1. Open laverna.cc and start using it. No extra steps are needed.
  2. Use a desktop app.
  3. Use a prebuilt version from Laverna/static-laverna repository.
  4. Build it from the source code.

Desktop app installation

Download the latest Laverna release for your operating system. After downloading the archive, you need to unpack it. Then, in the unpacked folder you need to run an executable (laverna.exe for Windows, laverna for Linux and Mac).

Arch Linux (or derived distributions)

The package can be found here.

For installation please use :

$ pacaur -S laverna

For issue about installation please report here or contact @funilrys on gitter here

Installation of a prebuilt version

1. Download

$ wget https://github.com/Laverna/static-laverna/archive/gh-pages.zip -O laverna.zip

2. Unpack the downloaded archive

$ unzip laverna.zip

3. Open index.html in a browser

Open in your favorite browser the index.html file which is located inside laverna directory.

Installation from source

To install, do the following:

1. Install Git

This project requires that you have the latest version of git installed. To do so, see Installing Git (first-time users of git might want to check out the next section for configuring git).

Note: Windows users will have to set the PATH variable for git after installing it.

2. Clone repository:

For those who plan on contributing to the project's development , hit the fork button at the top of the page first (others can go on to the next step). Open a terminal, or command line, and navigate to the desired location of where you want to download the repository. Then enter the following commands to clone the repo:

# clone the repository
$ git clone git@github.com:Laverna/laverna.git
# navigate to the project directory
cd laverna

3. Ensure you have the node.js platform installed. (See OS-specific instructions on their website).

4. Ensure you have the bower and gulp packages installed (locally and globally):

$ npm install bower
$ npm install -g bower
$ npm install gulp
$ npm install -g gulp

5. Install Laverna's dependencies:

$ npm install
$ bower install
$ cd test
$ bower install
$ cd ..

6. Build minified version of Laverna:

$ gulp build

7. Start Laverna:

$ gulp

Do you have questions?

Please have a look in our wiki.

Support

Coding Style Guidelines

For those wanting to contribute code, we ask that you use either plain JavaScript or the Marionette.js framework. (For more details on the preferred coding style see .editorconfig). Also, all experimental changes are being pushed on the dev branch, so any feature changes are preferred to be done on either this branch or a branch that uses the dev branch as its parent.

Donation:

Security

Laverna uses the [SJCL] 1 library implementing the AES algorithm. You can review the code at:

License

Published under MPL-2.0 License.

Laverna uses a lot of other libraries and each of these libraries use different licenses.