welel/noted

NoteD.

Empowering personal growth through shared knowledge.

This website helps to create personal notes, share them public, search for notes on a specific information source or interesting topics and save them, follow users and be followed by others. The project was created for my educational purposes, but has a practical application.

🔍 About

The goal of the project is to develop a system for creating, storing notes and searching for notes by sources of information.

A note is a summary of some material, for example: a book, video, course, article, etc. A source is a some information material. The user can search for public notes or notes by the name of the Source. The user can create public notes and drafts, subscribe to other users.

The benefit of this project is that a person studying any material reduces the time for taking notes.

Users can:

• look for notes of other people;
• start writing notes from other people's notes;
• to study the material in a short form, according to other people's notes;
• skimming over existing notes to find a Source to study something
• etc.

Main useful features:

• Create public notes (and drafts)
• Create a note on a specific source
• Copy (fork) and edit other's notes
• Search notes
• Search notes by a specific source
• Search for sources and list of notes on them
• Download notes [md, pdf, html]

Additional features:

• Add tags to notes
• Search notes by tags
• Subscribe to tags
• Follow users
• Pin your important notes
• Add notes to bookmarks

Notes are created in the markdown editor. The editor supports preview, split editing, full screen editing, hotkeys.

Dark mode / code highlight / code full-screen / mobile version.

🔥 Features

🛠️ Tech stack

🏗️ Installation

0. Prerequisites:

• sudo apt install g++
• sudo apt install build-essential
• sudo apt install libpq-dev python3-dev python3-pip python3.10-venv
• sudo apt install wkhtmltopdf for PDF files generation.
• sudo apt install gettext for translation.

1. Install PostgreSQL and create new database.

   To use trigrams in PostgreSQL, you will need to install the pg_trgm extension first. Execute the following command to install the pg_trgm extension inside a database: CREATE EXTENSION pg_trgm;

2. Clone or download the repository.

3. Create and activate virtual environment and install requirements from requirements/local.txt using Python 3.10.

4. Fill .env.dist file with required data and rename it to .env. Minimal requirements are SECRET_KEY and the database cofiguration (but then the functionality will be limited).

5. Make migrations and migrate with a custom command[1] or via Makefile[2].

# [1]
python manage.py makemigrate --settings=core.settings.local

# [2]
make setdb

6. Set up a cache backend or set a cache backend with following code in core/settings/local.py:

CACHES = {
    "default": {
        "BACKEND": "common.cache.RedisDummyCache",
    }
}

7. Set up Celery worker and Celery beat.

8. Run the development server with one of the following commands.

# [1]
python manage.py runserver --settings=core.settings.local

# [2]
make run

👨‍💻 Team

• Pavel Loginov (Backend/Frontend)
• Eduard Antadze (DevOps)