Skip to content

Commit 8811d00

Browse files
committed
Update readmes, fix tpyo
1 parent b8dbaf9 commit 8811d00

File tree

4 files changed

+42
-14
lines changed

4 files changed

+42
-14
lines changed

CONTRIBUTING.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
1-
# Project conventions
1+
# Project conventions and tips
22

33
1. Use [ShellCheck](https://www.shellcheck.net/)
4-
2. Indent with 4 spaces.
5-
3. Variables:
4+
2. You need to use this fork of innoextract: https://github.com/doZennn/innoextract
5+
3. You don't need to build anything. Work on `src.sh` directly, it will load `innoextract` from the cwd.
6+
4. Indent with 4 spaces.
7+
5. Variables:
68
- Global: `ALL_CAPS` - mostly static values used everywhere
79
- Local: `_underscore_prefix_and_lowercase` - only be used within a scope
8-
4. Always use `printf` instead of `echo`.
9-
5. Use LOTS of comments! Scripts are already hard to read especially when it's a bunch of pipes chained together, comments save time trying to figure out what something does.
10-
6. Everything must be as POSIX compliant as you can get it. It's okay to deviate from this within reason.
11-
7. Stick to using tools commonly installed by default on most distros, use fallbacks where appropriate.
12-
8. Final script must be functional when piped into `sh` (e.g. `cat zoom-platform.sh | sh`). An example of something you can't do is using `"$0"` to get the script name.
10+
6. Always use `printf` instead of `echo`.
11+
7. Use LOTS of comments! Scripts are already hard to read especially when it's a bunch of pipes chained together, comments save time trying to figure out what something does.
12+
8. Everything must be as POSIX compliant as you can get it. It's okay to deviate from this within reason.
13+
9. Stick to using tools commonly installed by default on most distros, use fallbacks where appropriate.
14+
10. Final script must be functional when piped into `sh` (e.g. `cat zoom-platform.sh | sh`). An example of something you can't do is using `"$0"` to get the script name.

README.md

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,29 @@
1-
# zoom-platform.sh
1+
# [zoom-platform.sh](https://zoom-platform.sh/)
2+
A tool to streamline installation, updating, and playing Windows games from [ZOOM Platform](https://www.zoom-platform.com/) on Linux using [umu](https://github.com/Open-Wine-Components/umu-launcher) and Proton.
23

4+
## Building
5+
| Script | Example | - |
6+
| - | - | - |
7+
| **build.sh** | `./build.sh "src.sh" "innoextract-upx" > output.sh` | Takes an input `src.sh`, embeds an innoextract binary, sets the version, prepends licences then prints the output. |
8+
| **dist.sh** | | Downloads innoextract then creates a `zoom-platform.sh` file using `build.sh` |
9+
10+
## Website
11+
The website is just a static `index.html` in [www/public](www/public).
12+
A small web server is used so users can get the script at the latest commit or a specific hash.
13+
See the [README](www/README.md) here.
14+
15+
## Usage
16+
For the script help, see `-h`.
17+
For the website:
18+
| URL (either http or https works) | |
19+
| - | - |
20+
| `curl zoom-platform.sh` | Returns the latest stable version of the script. |
21+
| `curl zoom-platform.sh/latest` | Returns the script built from the latest commit. |
22+
| `curl zoom-platform.sh/b8dbaf9` | Returns the script built from a specific commit. |
23+
| `curl zoom-platform.sh/b8dbaf9cde1f98c09d7da6874c3931014275fd4b` | Same as above but using the full hash. |
24+
25+
## Contributing
26+
Please see [CONTRIBUTING.md](CONTRIBUTING.md)
27+
28+
## Licence
29+
[BSD-3](LICENSE)

www/README.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,9 @@ Deno server only required if you want to be able to serve specific versions of t
33

44
## Deploying
55
1. Clone this repo
6-
2. `./dist.sh`
7-
3. `./start-www.sh` (saves latest stable script to www/dist)
8-
4. `deno task start` (optional)
9-
5. Serve `www/dist`
6+
2. `./start-www.sh` (saves latest stable script to www/public)
7+
3. `deno task start` (optional)
8+
4. Serve `www/public`
109

1110
We can't use GitHub/CF Pages cause they force SSL. Server is running Nginx with a simple config:
1211
```nginx

www/public/index.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -344,7 +344,7 @@
344344
</div>
345345
<main>
346346
<section id="description">
347-
<p><i class="color-primary">zoom-platform.sh</i> is an helpful tool to streamline installation, updating, and
347+
<p><i class="color-primary">zoom-platform.sh</i> is a helpful tool to streamline installation, updating, and
348348
playing Windows games from <a href="https://www.zoom-platform.com/">ZOOM Platform</a> on Linux using <a
349349
href="https://github.com/Open-Wine-Components/umu-launcher">umu</a> and
350350
Proton.</p>

0 commit comments

Comments
 (0)