mirror of
https://github.com/tiddly-gittly/TidGi-Desktop.git
synced 2026-03-02 12:00:45 -08:00
63 lines
4 KiB
Markdown
63 lines
4 KiB
Markdown
# TiddlyGit [](LICENSE)
|
|
|
|
| macOS | Linux | Windows |
|
|
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [](https://github.com/atomery/singlebox/actions?query=workflow%3AmacOS) | [](https://github.com/atomery/singlebox/actions?query=workflow%3ALinux) | [](https://github.com/atomery/singlebox/actions?query=workflow%3AWindows) |
|
|
|
|
**TiddlyGit** - Customizable personal knowledge-base with Github as unlimited storage and blogging platform.
|
|
|
|
## About TiddlyGit-Desktop
|
|
|
|
TiddlyGit is a cross-platform desktop app that make [nodejs-TiddlyWiki](https://github.com/Jermolene/TiddlyWiki5#installing-tiddlywiki-on-nodejs) easy to access.
|
|
|
|
The desktop app shell is based on [https://github.com/atomery/singlebox](atomery/singlebox) and [atomery/webcatalog](https://github.com/atomery/webcatalog), they provide lots of utils around website-generated-app, much powerful than generating app from website simply using Chrome.
|
|
|
|
### Why Github?
|
|
|
|
Because Github is one of the best free civil [BaaS](https://www.alibabacloud.com/blog/backend-as-a-service-baas-for-efficient-software-development_519851):
|
|
|
|
1. Its storage is basically free, allow us to store unlimited images and pdf files, which can have permanent URIs for public download
|
|
1. It has GraphQL API that allow us programmatically update our wiki
|
|
1. It has free [CI](https://github.com/features/actions) to automatically deploy our TiddlyWiki blog
|
|
1. It provides unlimited repository, public and private, which enables us to store private content into our TiddlyWiki
|
|
|
|
### Why not [TiddlyDesktop](https://github.com/Jermolene/TiddlyDesktop)?
|
|
|
|
Main reasons:
|
|
|
|
1. NodeJS version of TiddlyWiki have seamless auto-save experience, which is taking the advantage of SyncAdaptor instead of Syncer
|
|
1. We can have separated tiddler files, which can be modified by hand, or by other programs
|
|
1. Though TiddlyDesktop can load folder generated by nodejs-TiddlyWiki, it can't backup that folder to the Github easily
|
|
|
|
## Development
|
|
|
|
Development plan of TiddlyGit-Desktop is listed in these [Kanban](https://github.com/tiddly-gittly/TiddlyGit-Desktop/projects).
|
|
|
|
Explanation of our code can be found in the [Wiki](https://github.com/tiddly-gittly/TiddlyGit-Desktop/wiki).
|
|
|
|
<details>
|
|
<summary>To contribute, fork this repo, then clone it and setup development environment</summary>
|
|
|
|
```shell
|
|
# First, clone the project:
|
|
git clone https://github.com/YOUR_ACCOUNT/TiddlyGit-Desktop.git
|
|
cd TiddlyGit-Desktop
|
|
# Or maybe you are just using Github Desktop
|
|
# or GitKraken to clone this repo,
|
|
# and open it in your favorite code editor and terminal app
|
|
|
|
# install the dependencies
|
|
|
|
npm i
|
|
|
|
# Run development mode
|
|
|
|
npm run electron-dev
|
|
|
|
# Build for production
|
|
|
|
npm run dist
|
|
|
|
```
|
|
|
|
</details>
|