stuff-from-scratch/README.md

62 lines
1.7 KiB
Markdown
Raw Normal View History

2022-11-30 11:18:18 +00:00
# NotesTK
2022-11-30 11:18:18 +00:00
Notes Toolkit (NotesTK) is a set of tools for building applications focused on taking and organising notes, like study or research materials.
2022-11-30 11:18:18 +00:00
## Project Goals
2023-01-23 09:36:31 +00:00
* Cross-platform
* Low third-party dependencies
* Permissive licensing
* Simplicity over performance
2022-11-30 11:18:18 +00:00
## Project Status
2023-01-23 09:36:31 +00:00
🚨🚨🚨 The codebase is at a very early/prototype stage and under heavy active development🚨🚨🚨
In addition to feature development I've been using it to get up-to-speed on various media formats and desktop and rendering APIs. It is strongly recommended to only use it as a reading reference.
Expect:
2022-11-30 11:18:18 +00:00
* No Docs or tagged releases
* Large commits and significant breaking changes
2023-01-23 09:36:31 +00:00
* Unreliable/untested APIs
* Naive/low-performance implementations
2022-11-30 11:18:18 +00:00
2023-01-23 09:36:31 +00:00
The only currently recommended use case is if you are implementing some element of the library functionality and want to see how someone else has tackled it, maybe you will see something useful.
2022-11-30 11:18:18 +00:00
2023-01-23 09:36:31 +00:00
# Building
2022-11-30 11:18:18 +00:00
2023-01-23 09:36:31 +00:00
Many project features (e.g. Wayland integration) only build if suitable third-party dependencies are found on the system, otherwise they will be automatically disabled. You can find dependency requirements in the `README.md` file in each module's `src`directory.
2023-01-23 09:36:31 +00:00
A minimal set of dependencies for each platform are included below.
## Linux
2023-01-23 09:36:31 +00:00
Install dependencies:
```bash
2022-11-30 12:30:20 +00:00
sudo apt-get install build-essential pkg-config cmake
```
2023-01-23 09:36:31 +00:00
Build:
```bash
2023-01-23 09:36:31 +00:00
mkdir build
cd build
cmake $PATH_TO_SOURCE
make
apps/$NAME_OF_APP
2022-11-10 20:35:00 +00:00
```
2023-01-23 09:36:31 +00:00
## Windows
2023-01-23 09:36:31 +00:00
Tested with Visual Studio 17 with 'Desktop Development with C++' tooling, including ATL and Windows SDK 10 (10.0.19041.0). Additionally, install `cmake`.
2020-05-03 06:56:27 +00:00
```bash
mkdir build
cd build
cmake $PATH_TO_SOURCE
```
2023-01-23 09:36:31 +00:00
You can open the resulting `NotesTK.sln`in Visual Studio and build.