mirror of
https://github.com/wekan/wekan.git
synced 2025-04-23 13:37:09 -04:00
Copied updated Docs from wiki to WeKan repo.
Thanks to xet7 !
This commit is contained in:
Lauri Ojansivu
parent
23396d1bd6
commit
559251eb0d
13 changed files with 180 additions and 32 deletions
|
|
@ -1,23 +1,35 @@
|
|||
## WeKan Design Principles
|
||||
|
||||
- Prevent messing up something https://github.com/wekan/wekan/wiki/Monkey-Proof-Software
|
||||
- Original WeKan Design, that WeKan currently has: Intuitive, easy to figure out, polished UI/UX, menu options are there where you would expect then to be. Try to fix anything unexpected. New features added there where it makes most sense. And not so many duplicate menus and texts like Trello.
|
||||
- Not the exact design of Trello https://github.com/wekan/wekan/wiki/FAQ#why-does-wekan-look-so-different-now-compared-to--v09 . Also not the exact design of any other software. But note that design of all software changes often, when they are in active development.
|
||||
- Some features like Trello:
|
||||
- 2024-08 Design discussion here: https://github.com/wekan/wekan/discussions/5507
|
||||
- Original WeKan Design:
|
||||
- Kanban, the good parts. Like was done when figuring out best design for Swimlanes https://github.com/wekan/wekan/issues/955
|
||||
- Intuitive, easy to figure out, prevent messing up something https://github.com/wekan/wekan/wiki/Monkey-Proof-Software
|
||||
- Polished UI/UX
|
||||
- Menu options are there where you would expect then to be.
|
||||
- Try to fix anything unexpected.
|
||||
- New features added there where it makes most sense.
|
||||
- FOSS with MIT license
|
||||
- Swimlanes
|
||||
- All the use cases of WeKan feature/fix contributors
|
||||
- Cross-platform. Support many CPU/OS/Browsers for Desktop and Mobile.
|
||||
- Support many browsers https://github.com/wekan/wekan/wiki/Browser-compatibility-matrix . Add support for more.
|
||||
- PWA https://github.com/wekan/wekan/wiki/PWA
|
||||
- On-Premise:
|
||||
- Linux amd64/arm64/s390x
|
||||
- https://wekan.github.io/install/
|
||||
- https://github.com/wekan/wekan/wiki/Raspberry-Pi
|
||||
- Windows https://github.com/wekan/wekan/wiki/Offline
|
||||
- Mac https://github.com/wekan/wekan/wiki/Mac
|
||||
- Not like other software:
|
||||
- But note that design of all software changes often, when they are in active development.
|
||||
- Not bad parts of Trello:
|
||||
- Not the exact design of Trello https://github.com/wekan/wekan/wiki/FAQ#why-does-wekan-look-so-different-now-compared-to--v09
|
||||
- Not so many duplicate menus and texts like Trello
|
||||
- Not so much empty space
|
||||
- Some good parts of Trello:
|
||||
- Import from Trello
|
||||
- Shortcuts https://github.com/wekan/wekan/issues/1878
|
||||
- IFTTT Rules like Trello Butler https://github.com/wekan/wekan/wiki/IFTTT
|
||||
- Progress bar of checklist
|
||||
- Some features like Jira:
|
||||
- Multiple assignees
|
||||
- Some features not in Trello, like:
|
||||
- FOSS with MIT license
|
||||
- Self-hosting
|
||||
- Swimlanes
|
||||
- All the use cases of WeKan feature/fix contributors
|
||||
- Cross-platform. Support many CPU/OS/Browsers for Desktop and Mobile. Add support for more.
|
||||
- https://github.com/wekan/wekan/wiki/Browser-compatibility-matrix
|
||||
- https://github.com/wekan/wekan/wiki/PWA
|
||||
- https://github.com/wekan/wekan/wiki/Offline
|
||||
- https://github.com/wekan/wekan/wiki/Mac
|
||||
- https://github.com/wekan/wekan/wiki/Raspberry-Pi
|
||||
- Some good parts of Jira:
|
||||
- Multiple assignees
|
||||
|
|
@ -1,11 +1,49 @@
|
|||
## Meteor 3 Example Code
|
||||
|
||||
- https://github.com/fredmaiaarantes/simpletasks
|
||||
- MIT License
|
||||
- https://github.com/xet7/simpletasks
|
||||
- https://github.com/henriquealbert/meteor-with-prisma
|
||||
- MIT License
|
||||
- https://github.com/xet7/meteor-with-prisma
|
||||
- https://github.com/henriquealbert/meteor-pnpm
|
||||
- MIT License
|
||||
- https://github.com/xet7/meteor-pnpm
|
||||
|
||||
## Building Multi Platform Mobile Apps
|
||||
|
||||
- TWIM 058: Building Multi Platform Mobile Apps https://www.youtube.com/watch?v=ZTtXRJTUCIU
|
||||
- https://www.youtube.com/watch?v=ZTtXRJTUCIU
|
||||
- https://github.com/jamauro/pwa-kit
|
||||
- https://wekan.team/app/
|
||||
- https://github.com/wekan/wekan/wiki/PWA
|
||||
- Over 100 icons for different platforms https://github.com/wekan/wekan/blob/main/public/site.webmanifest
|
||||
|
||||
## Tip to any programmers
|
||||
|
||||
- Try to understand any error messages, and what to do to those errors
|
||||
|
||||
## Videos about upgrading to Meteor 3
|
||||
|
||||
- Storyteller
|
||||
- Upcoming:
|
||||
- 2024-09-02: Meteor.js generators https://www.youtube.com/watch?v=Z6nY2wqPgSE
|
||||
- 2024-09-09: Can we build static web pages with Meteor.js? https://www.youtube.com/watch?v=cr-Nm0YFb1w
|
||||
- 2024-09-16: Revisiting Mantra application architecture for today's Meteor.js https://www.youtube.com/watch?v=YyzY7ySqBAg
|
||||
- 2024-08-23: TWIM 052: Year of TWIM in review. Trying to of sometime have xet7 at TWIM show again. They recommended people to help xet7 when possible, xet7 is hitting some walls developing WeKan. https://www.youtube.com/watch?v=c5E3uZST4Vs
|
||||
- 2024-08-20:
|
||||
- Vazco interviewing Storyteller: How to approach building Open Source products? https://www.youtube.com/watch?v=j5BrTYcJDVc
|
||||
- Meteor inteviewing Storyteller: Programmer, open source contributor, entrepreneur https://www.youtube.com/watch?v=dsp0_r8uJx8
|
||||
- Meteor Roles:
|
||||
- 2024-07-33: Meteor Roles the full checkpoint https://www.youtube.com/watch?v=ow1i4UXdbbI
|
||||
- 2024-08-12: Meteor Roles building up teams https://www.youtube.com/watch?v=ZAuSYKfV114
|
||||
- 2024-07-15: WeKan Upgrades https://www.youtube.com/watch?v=Zjb3m9JsAD0
|
||||
- 2024-07-08: Upgrading Meteor examples https://www.youtube.com/watch?v=jzWXxOe93t4
|
||||
- Upcoming and past: https://www.youtube.com/@storytellercz/streams
|
||||
- React.js
|
||||
- WeKan uses Blaze and Jade, not React.
|
||||
- 2024-09-25:
|
||||
- Meteor 3 React Compiler: https://x.com/FilipeNevola/status/1838911432282583432
|
||||
- 2024-08-02:
|
||||
- https://www.youtube.com/watch?v=NnT7AbVMnj4
|
||||
- https://thenewstack.io/after-a-decade-of-react-is-frontend-a-post-react-world-now/
|
||||
|
|
|
|||
|
|
@ -1,3 +1,19 @@
|
|||
## What is not Cross-Platform
|
||||
|
||||
- Requires CPU to support AVX
|
||||
- Bun Javascript Engine https://bun.sh
|
||||
- MongoDB 5.x and newer https://github.com/turnkeylinux/tracker/issues/1724#issuecomment-2351544191
|
||||
- Does not work at s390x
|
||||
- V programming language https://github.com/vlang/v/issues/18737
|
||||
- Bun Javascript Engine https://github.com/oven-sh/bun/issues/2632
|
||||
- Deno Javascript Engine https://github.com/denoland/deno/issues/20212#issuecomment-1756663943
|
||||
- Lazarus IDE https://www.lazarus-ide.org
|
||||
- FreePascal programming language https://www.freepascal.org
|
||||
- TigerBeetle database https://github.com/tigerbeetle/tigerbeetle/issues/2241
|
||||
- GUI requires porting to other OS
|
||||
- BBC Basic https://www.bbcbasic.net/wiki/doku.php?id=converting_20programs_20from_20risc_20os_20to_20windows
|
||||
- Tcl/Tk GUI does works at most OS
|
||||
|
||||
## Prototype Strategy
|
||||
|
||||
- Try building many prototypes, see what works
|
||||
|
|
@ -265,8 +281,11 @@ https://github.com/wekan/php/blob/main/page/allboardschar.php
|
|||
|
||||
### FreePascal
|
||||
|
||||
- Repo https://github.com/wekan/hx/tree/main/prototypes/code/webserver/works/freepascal-router
|
||||
- Router and some webpage
|
||||
- Repo https://github.com/wekan/wami
|
||||
- Some static pages
|
||||
- Previous:
|
||||
- Repo https://github.com/wekan/hx/tree/main/prototypes/code/webserver/works/freepascal-router
|
||||
- Router and some webpage
|
||||
- Works at many retro and modern OS, but not at s390x that FreePascal does not support yet https://wiki.freepascal.org/ZSeries
|
||||
|
||||
### FreeDOS and Bash
|
||||
|
|
|
|||
|
|
@ -38,4 +38,9 @@ Reorder with drag drop:
|
|||
- Draggable objects
|
||||
- https://www.redblobgames.com/making-of/draggable/
|
||||
- https://news.ycombinator.com/item?id=37703291
|
||||
- Fixed Drag at Ubuntu Touch Morph browser https://github.com/wekan/wekan/commit/af63259f091cb2ade84493a288ea37c53cd37321
|
||||
- Fixed Drag at Ubuntu Touch Morph browser https://github.com/wekan/wekan/commit/af63259f091cb2ade84493a288ea37c53cd37321
|
||||
|
||||
## Touch UI ideas
|
||||
|
||||
- https://blog.la-terminal.net/godot-on-ipad-summer-update/
|
||||
- https://news.ycombinator.com/item?id=41415077
|
||||
|
|
@ -141,6 +141,8 @@ sudo snap set wekan mail-from='Wekan Team Boards <info@example.com>'
|
|||
```
|
||||
## Example: AWS SES
|
||||
|
||||
Related https://github.com/wekan/wekan/discussions/5518
|
||||
|
||||
NOTE: At AWS SES settings, you don't need to convert special characters.
|
||||
|
||||
1) At AWS SES, add verified sender email address, verified domain, verified DKIM etc.
|
||||
|
|
|
|||
11
docs/Features/Linked-Cards.md
Normal file
11
docs/Features/Linked-Cards.md
Normal file
|
|
@ -0,0 +1,11 @@
|
|||
Linked Card feature was added at https://github.com/wekan/wekan/pull/1592
|
||||
|
||||
With Linked Card feature, it's possible to create new board as dashboard, and link cards from other boards to current board, seeing realtimes changes from all those cards at dashboard.
|
||||
|
||||
Search is for searching card, to be as linked card, I presume.
|
||||
|
||||
There is also Linked Board, but I'm not sure is it useful.
|
||||
|
||||
Related PRs at https://github.com/wekan/wekan/pulls?q=is%3Apr+is%3Aclosed+linked+card+
|
||||
|
||||
Related issue https://github.com/wekan/wekan/issues/5550
|
||||
|
|
@ -9,20 +9,24 @@ Sandstorm has SAML login, and old WeKan that will be updated someday:
|
|||
|
||||
How SAML works:
|
||||
|
||||
- https://ssoready.com/blog/engineering/a-gentle-intro-to-saml/
|
||||
- https://ssoready.com
|
||||
- https://github.com/ssoready/ssoready
|
||||
- https://news.ycombinator.com/item?id=41110850
|
||||
- https://ssoready.com/blog/from-the-founders/an-unpopular-perspective-on-the-sso-tax/
|
||||
- https://news.ycombinator.com/item?id=41303844/blog/engineering/a-gentle-intro-to-saml/
|
||||
- https://news.ycombinator.com/item?id=41036982
|
||||
- https://www.sheshbabu.com/posts/visual-explanation-of-saml-authentication/
|
||||
- https://news.ycombinator.com/item?id=41057814
|
||||
- https://github.com/ssoready/ssoready
|
||||
- https://news.ycombinator.com/item?id=41110850
|
||||
- https://ssoready.com/blog/from-the-founders/an-unpopular-perspective-on-the-sso-tax/
|
||||
- https://news.ycombinator.com/item?id=41303844
|
||||
|
||||
Ruby on Rails OmniAuth, that has Shibboleth and SAML:
|
||||
|
||||
- https://github.com/omniauth/omniauth/wiki/List-of-Strategies
|
||||
- https://github.com/omniauth/omniauth
|
||||
|
||||
SAML at SSOReady:
|
||||
|
||||
- https://github.com/ssoready/ssoready
|
||||
- https://news.ycombinator.com/item?id=41110850
|
||||
- Recent SAML issue https://news.ycombinator.com/item?id=41586031
|
||||
|
||||
The SSO Wall of Shame:
|
||||
|
||||
|
|
|
|||
5
docs/Platforms/FOSS/Cloud/CloudFlare.md
Normal file
5
docs/Platforms/FOSS/Cloud/CloudFlare.md
Normal file
|
|
@ -0,0 +1,5 @@
|
|||
CNAME to CNAME does not work well. Last one should be A IPv4 (and AAAA IPv6).
|
||||
|
||||
To get Let's Encrypt SSL/TLS cert for custom subdomain, for example with Caddy, you subdomain should have grey cloud icon. Not orange cloud icon CloudFlare proxy. Also turn off any SSL/TLS of CloudFlare. This is so that Let's Encrypt verifying servers can see hosting server actual IP address and validate cert.
|
||||
|
||||
If needing wildcard SSL/TLS cert, for example for Sandstorm, create CloudFlare Origin Certificate, add it to Caddy or Nginx certs .pem file (private key above, other key below, at same textfile). Set CloudFlare SSL/TLS as Strict for using Origin Certificate. Set DNS to orange cloud icon proxy. Add DNS records for example.com , *.example.com , www.example.com .
|
||||
|
|
@ -283,4 +283,4 @@ sudo docker compose up -d --build
|
|||
|
||||
* [Caddy Webserver Config](Caddy-Webserver-Config)
|
||||
* [Nginx Webserver Config](Nginx-Webserver-Config)
|
||||
* [Apache Webserver Config](Apache)
|
||||
* [Apache Webserver Config](Apache)
|
||||
|
|
@ -1,6 +1,54 @@
|
|||
# Sandstorm at Debian and Ubuntu
|
||||
|
||||
### Sandstorm CloudFlare DNS settings
|
||||
|
||||
Source: https://github.com/sandstorm-io/sandstorm/issues/3714#issuecomment-2366866243
|
||||
|
||||
For me, it works at CloudFlare DNS using TLS Strict checking and DNS setting clicking to orange cloud icon to make TLS proxy with Origin certificate, that is at /etc/caddy/certs/example.com.pem with above private key and below cert.
|
||||
|
||||
DNS records:
|
||||
```
|
||||
* A example.com ip-address
|
||||
@ A example.com ip-address
|
||||
```
|
||||
Caddyfile, proxy to KVM VM that is running Debian and Sandstorm:
|
||||
```
|
||||
*.example.com example.com {
|
||||
tls {
|
||||
load /etc/caddy/certs
|
||||
alpn http/1.1
|
||||
}
|
||||
|
||||
reverse_proxy 123.123.123.123:80
|
||||
}
|
||||
```
|
||||
At /opt/sandstorm/sandstorm.conf is domain, http port etc.
|
||||
|
||||
Some related info at:
|
||||
|
||||
https://github.com/wekan/wekan/wiki/Caddy-Webserver-Config
|
||||
|
||||
I also had to wait that Origin certificate becomes active.
|
||||
|
||||
But this worked for me only at CloudFlare. It did not work at FreeDNS of Namecheap.
|
||||
|
||||
Also, I still need to write script to fix IP address if Dynamic DNS IP address changes, using CloudFlare API, because my cable modem does not have DDNS option for CloudFlare.
|
||||
|
||||
Now that there is also a way to run Sandstorm at Ubuntu, it would be possible for me to move Sandstorm from KVM VM to run directly at host, without VM, and proxy from Caddy to localhost port of Sandstorm.
|
||||
|
||||
https://groups.google.com/g/sandstorm-dev/c/4JFhr7B7QZU?pli=1
|
||||
|
||||
### Debian amd64
|
||||
|
||||
Installing Sandstorm works normally
|
||||
|
||||
### Ubuntu 24.04 amd64
|
||||
|
||||
How to install Sandstorm: https://groups.google.com/g/sandstorm-dev/c/4JFhr7B7QZU
|
||||
|
||||
## Sandstorm Website
|
||||
|
||||
[Sandstorm Website](https://sandstorm.io)
|
||||
[Sandstorm Website](https://sandstorm.org)
|
||||
|
||||
If you have any grains at Sandstorm's **Oasis montly paid service**, please move those to self-hosted, because [only **Oasis grain hosting** part is shutting down](https://sandstorm.io/news/2019-09-15-shutting-down-oasis) - [HN](https://news.ycombinator.com/item?id=20979428). This does not affect any other parts like self-hosting at sandcats.io, App Market, updates, etc.
|
||||
|
||||
|
|
|
|||
|
|
@ -10,6 +10,9 @@
|
|||
- https://arstechnica.com/information-technology/2023/07/the-ibm-mainframe-how-it-runs-and-why-it-survives/
|
||||
- https://sdl-hercules-390.github.io/html/
|
||||
- Big-endian s390x https://community.ibm.com/community/user/ibmz-and-linuxone/blogs/javier-perez1/2021/01/19/endianness-guidance-for-open-source-projects
|
||||
- The Future of Big Iron: An Interview with IBM’s Christian Jacobi
|
||||
- https://morethanmoore.substack.com/p/the-future-of-big-iron-telum-ii-and
|
||||
- https://news.ycombinator.com/item?id=41846592
|
||||
|
||||
***
|
||||
|
||||
|
|
|
|||
|
|
@ -8,19 +8,19 @@ This is without container (without Docker or Snap).
|
|||
|
||||
Right click and download files 1-4:
|
||||
|
||||
1. [wekan-7.59-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.59/wekan-7.59-amd64-windows.zip)
|
||||
1. [wekan-7.61-amd64-windows.zip](https://github.com/wekan/wekan/releases/download/v7.61/wekan-7.61-amd64-windows.zip)
|
||||
|
||||
2. [node.exe](https://nodejs.org/dist/latest-v14.x/win-x64/node.exe)
|
||||
|
||||
3. [mongodb-windows-x86_64-6.0.17-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.17-signed.msi)
|
||||
3. [mongodb-windows-x86_64-6.0.18-signed.msi](https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.18-signed.msi)
|
||||
|
||||
4. [start-wekan.bat](https://raw.githubusercontent.com/wekan/wekan/main/start-wekan.bat)
|
||||
|
||||
5. Copy files from steps 1-4 with USB stick or DVD to offline Windows computer
|
||||
|
||||
6. Double click `mongodb-windows-x86_64-6.0.17-signed.msi` . In installer, uncheck downloading MongoDB compass.
|
||||
6. Double click `mongodb-windows-x86_64-6.0.18-signed.msi` . In installer, uncheck downloading MongoDB compass.
|
||||
|
||||
7. Unzip `wekan-7.59-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files:
|
||||
7. Unzip `wekan-7.61-amd64-windows.zip` , inside it is directory `bundle`, to it copy other files:
|
||||
|
||||
```
|
||||
bundle (directory)
|
||||
|
|
|
|||
|
|
@ -128,6 +128,7 @@
|
|||
|
||||
# <a name="Features"></a>Features
|
||||
|
||||
* [Linked Cards](Linked-Cards)
|
||||
* [Drag Drop](https://github.com/wekan/wekan/wiki/Drag-Drop) on Mobile and Desktop
|
||||
* [Rclone: Store attachments to cloud storage like S3, MinIO, etc](Rclone)
|
||||
* [Python based features](Python)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue