forked from zusam/zusam
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Co-authored-by: Neriderc <[email protected]> Co-authored-by: Daniil Kozheikin <[email protected]> Co-authored-by: Milan Šalka <[email protected]> Co-authored-by: YuxiangWang_0525(John Frederick Wang) <[email protected]> Co-authored-by: Allan Nordhøy <[email protected]> Co-authored-by: gallegonovato <[email protected]> Co-authored-by: Bruno-Van-den-Bosch <[email protected]> Co-authored-by: tabby <[email protected]> Co-authored-by: Asmodeus <[email protected]> Co-authored-by: Zina <[email protected]> Co-authored-by: தமிழ்நேரம் <[email protected]> Co-authored-by: Ettore Atalan <[email protected]> Co-authored-by: Ugur Saglam <[email protected]>
- Loading branch information
1 parent
e2d688a
commit 5930fdf
Showing
153 changed files
with
8,250 additions
and
6,596 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,15 @@ | ||
name: Lang tests | ||
|
||
on: [pull_request] | ||
|
||
jobs: | ||
validate-json: | ||
runs-on: ubuntu-latest | ||
|
||
steps: | ||
- name: Checkout code | ||
uses: actions/checkout@v3 | ||
|
||
- name: Validate JSON files | ||
run: | | ||
find app/src/lang -type f -name "*.json" -exec jq . {} \; || exit 1 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,68 @@ | ||
# Contributing to Zusam | ||
|
||
Thank you for considering contributing to Zusam! There are many ways that you can help, some of which are outlined below. | ||
|
||
<!-- TOC --> | ||
* [Contributing to Zusam](#contributing-to-zusam) | ||
* [Report bugs and issues or request features](#report-bugs-and-issues-or-request-features) | ||
* [Translate Zusam](#translate-zusam) | ||
* [Contributing code](#contributing-code) | ||
* [Pull requests](#pull-requests) | ||
* [Setting up dev environment](#setting-up-dev-environment) | ||
<!-- TOC --> | ||
|
||
## Report bugs and issues or request features | ||
|
||
If you find a problem with Zusam, or if you think of a valuable feature you would like implemented, open a new issue on GitHub and describe it for us. | ||
|
||
If you find a security vulnerability, do NOT open an issue. Please instead use the [GitHub security disclosure](https://github.com/zusam/zusam/security) functionality. Also see [SECURITY.md](./SECURITY.md). | ||
|
||
## Translate Zusam | ||
|
||
You can help translate Zusam into your language by using [Weblate](https://hosted.weblate.org/projects/zusam/core/). You can log in using your GitHub account or register for a new Weblate account. | ||
|
||
## Contributing code | ||
|
||
Please note this project is [AGPLv3 licenced](https://www.gnu.org/licenses/agpl.html), and all contributions are under the same licence. Please ensure all work is your own. | ||
|
||
If you're new to contributing, see [this tutorial](https://github.com/firstcontributions/first-contributions) on contributing to projects on GitHub. | ||
|
||
Check out the [Issues](https://github.com/zusam/zusam/issues) for things that need attention. | ||
|
||
### Pull requests | ||
|
||
Please target any pull requests to the `next` branch. This branch will be merged into `master` with each release. | ||
|
||
### Setting up dev environment | ||
|
||
Start by cloning the repo. Go to the folder you want to put it inside then: | ||
|
||
`git clone https://github.com/zusam/zusam.git` | ||
|
||
Go into the zusam directory and build the dev version: | ||
|
||
`cd zusam && dev/start-dev-container` | ||
|
||
You might get an error that it can't find the container that it just built. This is often related to a podman installation. To get around this, run the make command specifically targeting docker before running the start-dev-container script: | ||
|
||
`make dev container_pgrm=docker` | ||
|
||
You'll now be inside the container, in the zusam directory. `cd app` to get to the front end app directory, then run `npm install --save-dev` to install the npm packages. | ||
|
||
Next, compile the webapp and copy to the public directory with: | ||
|
||
`npm run build; rm -r ../public/*.{js,css,map,png}; cp -r dist/* ../public/` | ||
|
||
Now install the composer dependencies by running: | ||
|
||
`cd /zusam/api && php bin/composer install` | ||
|
||
Now exit the container with ctrl + D and then run the container using repo files using: | ||
|
||
`dev/start-test-container` | ||
|
||
You should now be able to access Zusam on [http://localhost:8080](http://localhost:8080). A user `zusam` with password `zusam` is created by default. | ||
|
||
Any code updates you make in the `api` directory should be reflected immediately in this running instance. For the web app in the `app` directory, after making changes you will need to rerun the command to build and copy to the public directory: | ||
|
||
`npm run build; rm -r ../public/*.{js,css,map,png}; cp -r dist/* ../public/` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
# Reporting Security Issues | ||
|
||
The Zusam team and community take security bugs in Zusam seriously. We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions. | ||
|
||
To report a security issue, please use the GitHub Security Advisory ["Report a Vulnerability"](https://github.com/zusam/zusam/security/advisories/new) tab. | ||
|
||
The Zusam team will send a response indicating the next steps in handling your report. After the initial reply to your report, the security team will keep you informed of the progress towards a fix and full announcement, and may ask for additional information or guidance. | ||
|
||
Please report security bugs in third-party modules to the person or team maintaining the module. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.