Giter Club home page Giter Club logo

jour's Introduction

jour

the simplest possible journal.

install:

$ git clone [email protected]:bsima/jour.git ~/jour
$ cd jour
$ sudo make install
$ jour --help

I've kept paper journals, digital journals in evernote and wordpress, etc. I've learned not to trust digital journals because the formats change, or I lose the data in "the cloud" somewhere. The only digital journal I trust nowadays is my own collection of text files, stored in a git repo on my own server.

In any case, the point of this very small CLI program is to show just how simple a journal can be. Personally I use this weekly for diary-like entries and saving links or thoughts while I'm working. I also keep a few paper journals around for less-structured notes, mobile notes (I've never found a good note-taking app for phones), or random sketching.

The point of this isn’t to be a generally useful tool for everyone. Rather, it’s just to show that something like this is super simple, and you shouldn’t look for a fancy tool to help you keep a journal. Just use the simplest thing that gets the job done. This script could also be a shell script or a few lines of vimscript/elisp, but jour works for me so I share it :)

Another great thing for notetaking: Ryan Holiday's notecard system, which ends up resembling a relational database when taken to the extreme (see the Robert Greene blockquote in that link).

jour's People

Contributors

peterbeard avatar satanforlink avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

jour's Issues

License?

I noticed this code doesn't have a license associated with it. A lot of people won't contribute to a project unless it's clear what the license is. Also, without a license, nobody else is technically allowed to use, improve, or redistribute this code, so you should specify a license if that's not what you intended. You can take a look at http://choosealicense.com/ if you haven't thought about what license you'd like to use.

Anyway, thanks a lot for making this and (hopefully) making it free software.

Populate new journal entry with YAML frontmatter

Most markdown parses include YAML frontmatter, which jour uses for tags:

---
tags: work, tea
---

Today I worked on code stuff while drinking tea...

jour ls then prints this as

2017.05.02 : work, tea

which is nice. It would be great though if jour automatically put the YAML frontmatter in the $EDITOR buffer when I started writing a new journal entry.

Had to make my own journal dir after install

Traceback (most recent call last): File "/usr/local/bin/jour", line 46, in <module> raise NotADirectoryError("{0} does not exist.".format(journal_dir)) NotADirectoryError: /Users/Ryan/journal does not exist.

Made one myself, but would be cool if install went ahead and did it on its own.

Also: found this on Lobsters!

Small world!

Hope you're doing well.

Add journaling statistics?

I'm imagining something like this:

$ jour stats
Average words per entry: 362
Frequency of entries: 2.4 per week
Most common tags: tag1, tag2, tag3

Maybe a more table-like layout would be better. I'm not sure.

The other question is: do I even want to add a stats feature to this? Maybe that is better suited as an exercise for the user? With a sufficiently large journal, these stats calculations will take a lot of time to run. And I definitely don't want to start requiring numpy etc for this simple script.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.