Skip to content

A lightweight logbook application using python django

Notifications You must be signed in to change notification settings

ReubenHawley/LogBook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

ICT-logbook

A lightweight django application for using as a logbook
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Besides that you are probably required to keep a logbook of activities for your university study. A logbook can help you to identify areas of growth or lack thereof. Often during a project, we run into issues, it is a important to be able to reflect on these issues so that they dont turn themselves into repeat mistakes.

Here's why:

  • Excel sucks
  • Word is meant for essays, a logbook entry should be short and give insight into a specific set of circumstances
  • Dev's who can reflect and learn from their mistakes, make the world a better place.

This logbook might not suit all your needs, so feel free to fork the repo or if you have a fundamental feature you want to see, feel free to open a request. Use the BLANK_README.md to get started.

(back to top)

Built With

wait! thats it? yes... i said lightweight didnt i?

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

To check if python is installed type the following in the commandline/Powershell/bash

python --version

Installation

Below is an example of how you can instruct your audience on installing and setting up your app. This template doesn't rely on any external dependencies or services.

  1. Clone the repo
    git clone https://github.com/ReubenHawley/LogBook.git
  2. Create virtual env
    python3 -m venv /path/to/new/virtual/environment
  3. Run the install file
    ./install.sh
  4. Follow the instructions from django to create a superuser

(back to top)

Usage

To use the application:

  1. run the django app
    python  manage.py runserver
  2. open your browser
    http://127.0.0.1:8000/admin/
    
  3. Log in using the credentials you passed in the commandline
  4. Enjoy logging

(back to top)

Roadmap

  • Add Gui for viewing logs

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Reuben Hawley - @theonlyReuben - reubenhawley@gmail.com

Project Link: https://github.com/ReubenHawley/LogBook

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

(back to top)

About

A lightweight logbook application using python django

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published