https://github.com/tlnagy/jekyll-lab-notebook

📓 A full-featured electronic lab notebook theme (with plugins!) for Jekyll
https://github.com/tlnagy/jekyll-lab-notebook

electronic-lab-notebook jekyll jekyll-plugin jekyll-theme

Last synced: about 2 months ago
JSON representation

📓 A full-featured electronic lab notebook theme (with plugins!) for Jekyll

• Host: GitHub
• URL: https://github.com/tlnagy/jekyll-lab-notebook
• Owner: tlnagy
• License: mit
• Created: 2017-07-19T19:22:56.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2020-09-09T22:03:43.000Z (about 4 years ago)
• Last Synced: 2024-07-25T03:06:46.006Z (about 2 months ago)
• Topics: electronic-lab-notebook, jekyll, jekyll-plugin, jekyll-theme
• Language: SCSS
• Homepage: http://tamasnagy.com/jekyll-lab-notebook
• Size: 698 KB
• Stars: 61
• Watchers: 5
• Forks: 10
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# 📓 jekyll-lab-notebook

[![Gem Version](https://badge.fury.io/rb/jekyll-lab-notebook.svg)](https://badge.fury.io/rb/jekyll-lab-notebook)

[![Build Status](https://travis-ci.org/tlnagy/jekyll-lab-notebook.svg?branch=master)](https://travis-ci.org/tlnagy/jekyll-lab-notebook)

Supercharge your electronic lab notebook!

This is a full-featured jekyll theme that lets you quickly write markdown

notebook entries and will create a great HTML website that you can run locally

to view all your hard work. It's hackable to its core so you can tweak it to

your heart's desire. Add pages, change layouts, add cool jekyll plugins,

whatever; think of this as your springboard.

[LIVE DEMO HERE](http://tamasnagy.com/jekyll-lab-notebook/)

![](screenshot.png)

![](screenshot2.png)

## Features

- Take simple markdown notes in your favorite text editor (I recommend [Atom](https://atom.io/))

- Easily embed images, CSVs, or PDFs in your protocols/logs/wherever

- Interactive calendar to show you when you had log entries

- Enter your log entries chronologically, but then tag them so they show up with other entries on the same project (Multi-project tags supported too!)

- Add highlighted sections (note or thought bubbles) to draw attention to important things

## Installation and Usage

The `demo/` folder contains a fully functioning example ELN. Clone this repo and navigate into the `demo/` folder. Make sure you have a recent version of ruby installed and then run

```

gem install bundler

```

which will install the `bundle` package manager. Next, run

```

bundle update

```

inside the `demo/` folder, which will install all the necessary packages. Then run

```

bundle exec jekyll serve -wi

```

to actually serve the ELN and navigate to the address listed using your browser to see your ELN. Edit the posts inside the `_posts/` subdirectory to add entries.

## Contributing

This project is split into two main reports

- The one you're on, which is where all the layout and design stuff happens

- The [plugins](https://github.com/tlnagy/jekyll-lab-notebook-plugins) repo, this where the heavy lifting happens.

Bug reports and pull requests are welcome on GitHub at  and at . This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

## Development

TODO

## License

The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).