tcp-wiki/README.md

83 lines
2.5 KiB
Markdown
Raw Normal View History

# TCP-WIKI
Feel free to commit, leave suggestions/ideas, issues, or really anything <3
2023-04-02 12:24:07 -07:00
# What is TCP-WIKI ?
<center><img src="https://tcp.ac/i/TIZzK" alt="example screenshot" width="100" height="400"></center>
TCP.WIKI is a secure and verifiable wiki platform designed for projects, code, courses, documents, articles, blogs, tutorials, and more.
2023-04-15 16:16:27 -07:00
### Project Goals
2023-04-15 16:16:27 -07:00
The aim is to provide a secure, minimal, and easily verifiable wiki environment that supports a wide range of content types, from technical documentation, to educational materials, to blogs, and more.
## Setup
2023-04-12 05:29:36 -07:00
First clone this repository:
2023-04-12 05:29:36 -07:00
```bash
git clone https://git.tcp.direct/S4D/tcp-wiki.git
```
Then you have to cd into the repo's folder and run/compile:
```bash
cd tcp-wiki
go run ./src
2023-04-12 05:29:36 -07:00
```
Then you goto your browser and visit: http://127.0.0.1:8080/
## Want to use with your own data?
2023-04-12 05:29:36 -07:00
All you have to do is modify the following lines in the `config.toml` file:
```toml
[Git]
UseGit = true # Set to false to use LocalPath
RepoURL = "https://git.tcp.direct/S4D/tcp-wiki.git" # Your Repo Here
Branch = "main" # Your Repo Branch Here
LocalPath = "data" # Directory to clone the git repo too
```
2023-04-12 05:29:36 -07:00
Change the `RepoURL` line `https://git.tcp.direct/S4D/tcp-wiki.git` to your repo link,
change `main` to your specific repo's branch and you should be good to go!
2023-04-12 05:29:36 -07:00
#### Want to use a local directory other then git repo?
2023-04-12 05:29:36 -07:00
To do this you just need to set `UseGit` to `false` and set your directory in config.toml
```toml
[Git]
UseGit = false # Set this to false
RepoURL = "" # Ignored
Branch = "" # Ignored
LocalPath = "/home/crazy/blog" # The directory of your project
```
make sure to also set `LocalPath` to the directory of your project
> ### Want to use your own theme/layout?
>
> Have a look at the `assets/` directory for the templates
2023-04-12 05:29:36 -07:00
2023-04-02 12:24:07 -07:00
## TODO
- [x] config file
2023-04-02 12:24:07 -07:00
- [ ] Webhook support for auto pull on push/update of the git repo
- [x] Git Branch support
2023-04-02 13:02:07 -07:00
- [ ] add a star/upvote/like feature for pages
2023-04-12 18:35:10 -07:00
- [x] edit/version tracker
- [x] Author
- [x] last edited
- [x] last editor/commit - maybe working
- [ ] PGP Signed & Verification
- [ ] pgp signed intergration
2023-04-12 05:29:36 -07:00
- [x] comments using bitcask - generated in comments.db/
- [ ] verification - no login pgp
- [ ] captcha
- [ ] sub rating system
- [ ] sort by date etc
2023-04-12 05:29:36 -07:00
- [ ] reply to replies
- [ ] set security controls per page
2023-04-12 15:45:55 -07:00
- [ ] auto refresh on post
2024-02-09 18:27:04 -08:00
- [x] dynamically generated links for all avaiable pages
- [x] sitemap - kinda
- [x] working pages
2024-02-09 18:27:04 -08:00
- [ ] image support