mirror of
https://github.com/yu-i-i/overleaf-cep.git
synced 2026-05-25 02:00:10 +02:00
a648015db8
* Merge all .prettierignore files into top-level config * Merge all .prettierrc files into top-level config * Replace service-specific glob patterns in package.json format scripts with `prettier .` * Add template files with Jinja2, Go template, envsubst, and Handlebars syntax to .prettierignore * Ignore GitHub templates * Ignore PUG templates to format them separately with `format:pug` * Encourage double quotes for YAML, YML files * Move prettier for PUG source format script to the root * Move prettier for styles source format script to the root * Remove prettier for jenkins files from web * Remove prettier source format script from all services * Make .prettierrc more readable * Update format scripts by file type * Organise `.prettierignore` * Add `--cache` flag to prettier scripts for faster runs * Format all files with prettier * Format all or format services * Remove `format`/`format:fix` scripts from services since now it runs from root `package.json` * Avoid conlficts with yamllint configuration * Remove `--cache` flag from prettier scripts * Update all service Makefiles to use root-level prettier configuration * Update all Jenkinsfile to use root-level prettier configuration * Ignore auto-generated files by build_scripts * Update package-lock.json * Update root Makefile format targets * Update SP Jenkinsfile format target * Update E2E Makefile format script * Udpate `format_js` to work in both local and CI env * Add docker-mailtrap to .prettierignore docker-mailtrap is a third-party git-ignored directory used for testing * Added Docker env detection to prevent nested Docker spawning * Ignore handlebars templates * Add cryptographic files and test output to `.prettierignore` * Add terraform modules to `.gitignore` * Remove prettier-plugin-groovy * Use npx directly instead of Docker for local formatting for faster formatting * Auto-generate Makefiles * Revert "Remove prettier-plugin-groovy" This reverts commit 194a33589a2e1e4d2225d10c67e9f025e4222025. * Mount monorepo root in RUN_LINT_FORMAT for prettier config access * Prettier ignores all `node_modules` by default regardless of location * Show only changed files in format output * Ignore LICENSE files * Enable prettier on rendered build_scripts outputs * Ignoring all the template folders by prettier * Remove the public/minjs entry since it does not exist * Remove all non-existent paths * Sync `.prettierignore` with ignored files by `.gitignore` and `.dockerignore` files * Revert "Auto-generate Makefiles" This reverts commit c0233e490de1bc95fe437219d65e0b66e0331ec9. * Revert "Use npx directly instead of Docker for local formatting for faster formatting" This reverts commit 1d2b2cf1a6c6974c76885852a90dd55e84167e41. * Ignore dashboard JSON files * Ignore files generated by bin/update_build_scripts * Remove unsupported file types from `.prettierignore` * Ignore test fixture generated files * Ignore README file types by prettier * Ignore generate snapshots by prettier * Allow to format generated bin/update_build_scripts by prettier * Ensure build script outputs prettier-compatible tsconfig.json * Fix build script output to match prettier formatting - Fix Jinja2 whitespace in docker-compose templates - Change YAML quotes from single to double * Don't read cryptographic files by prettier * Ignore google verification files by prettier * Revert npx prettier formatting * Ignore domain verification files * Show only changed files in format output * Make `.github` prettier * Allow all files to be formatted in jobs by prettier * Allow server-ce/server-pro files to be formatted by prettier * Ignore more folders in clsi, filestory, git-bridge by prettier * Update build script with `RUN_LINTING_CI_MONOREPO` * Ignore docker-mailtrap and downloads in server-ce by prettier * Restore prettier configs and prettierignore for V1 since it has its own prettier (an older version) * Source format GitOrigin-RevId: 637adc3cc422d1f20c86d6ebc8ec514d60758287
131 lines
3.6 KiB
Markdown
131 lines
3.6 KiB
Markdown
# overleaf/web
|
|
|
|
overleaf/web is the front-end web service of the open-source web-based collaborative LaTeX editor,
|
|
[Overleaf](https://www.overleaf.com).
|
|
It serves all the HTML pages, CSS and javascript to the client. overleaf/web also contains
|
|
a lot of logic around creating and editing projects, and account management.
|
|
|
|
The rest of the Overleaf stack, along with information about contributing can be found in the
|
|
[overleaf/overleaf](https://github.com/overleaf/overleaf) repository.
|
|
|
|
### Running the app
|
|
|
|
The app runs natively using npm and Node on the local system:
|
|
|
|
```
|
|
$ npm install
|
|
$ npm run start
|
|
```
|
|
|
|
### Running Tests
|
|
|
|
To run all tests run:
|
|
|
|
```
|
|
make test
|
|
```
|
|
|
|
To run both unit and acceptance tests for a module run:
|
|
|
|
```
|
|
make test_module MODULE=saas-authentication
|
|
```
|
|
|
|
### Unit Tests
|
|
|
|
The test suites run in Docker.
|
|
|
|
Unit tests can be run in the `test_unit` container defined in `docker-compose.tests.yml`.
|
|
|
|
The makefile contains a short cut to run these:
|
|
|
|
```
|
|
make test_unit
|
|
```
|
|
|
|
During development it is often useful to only run a subset of tests, which can be configured with arguments to the mocha CLI:
|
|
|
|
```
|
|
make test_unit MOCHA_GREP='AuthorizationManager'
|
|
```
|
|
|
|
To run only the unit tests for a single module do:
|
|
|
|
```
|
|
make test_unit_module MODULE=saas-authentication
|
|
```
|
|
|
|
Module tests can also use a MOCHA_GREP argument:
|
|
|
|
```
|
|
make test_unit_module MODULE=saas-authentication MOCHA_GREP=SSO
|
|
```
|
|
|
|
### Acceptance Tests
|
|
|
|
Acceptance tests are run against a live service, which runs in the `acceptance_test` container defined in `docker-compose.tests.yml`.
|
|
|
|
To run the tests out-of-the-box, the makefile defines:
|
|
|
|
```
|
|
make test_acceptance
|
|
```
|
|
|
|
However, during development it is often useful to leave the service running for rapid iteration on the acceptance tests. This can be done with:
|
|
|
|
```
|
|
make test_acceptance_app_start_service
|
|
make test_acceptance_app_run # Run as many times as needed during development
|
|
make test_acceptance_app_stop_service
|
|
```
|
|
|
|
`make test_acceptance` just runs these three commands in sequence and then runs `make test_acceptance_modules` which performs the tests for each module in the `modules` directory. (Note that there is not currently an equivalent to the `-start` / `-run` x _n_ / `-stop` series for modules.)
|
|
|
|
During development it is often useful to only run a subset of tests, which can be configured with arguments to the mocha CLI:
|
|
|
|
```
|
|
make test_acceptance_run MOCHA_GREP='AuthorizationManager'
|
|
```
|
|
|
|
To run only the acceptance tests for a single module do:
|
|
|
|
```
|
|
make test_acceptance_module MODULE=saas-authentication
|
|
```
|
|
|
|
Module tests can also use a MOCHA_GREP argument:
|
|
|
|
```
|
|
make test_acceptance_module MODULE=saas-authentication MOCHA_GREP=SSO
|
|
```
|
|
|
|
## Routes
|
|
|
|
Run `bin/routes` to print out all routes in the project.
|
|
|
|
## License and Credits
|
|
|
|
This project is licensed under the [AGPLv3 license](http://www.gnu.org/licenses/agpl-3.0.html)
|
|
|
|
### Stylesheets
|
|
|
|
Overleaf is based on [Bootstrap](http://getbootstrap.com/), which is licensed under the
|
|
[MIT license](http://opensource.org/licenses/MIT).
|
|
All modifications (`*.less` files in `public/stylesheets`) are also licensed
|
|
under the MIT license.
|
|
|
|
### Artwork
|
|
|
|
#### Silk icon set 1.3
|
|
|
|
We gratefully acknowledge [Mark James](http://www.famfamfam.com/lab/icons/silk/) for
|
|
releasing his Silk icon set under the Creative Commons Attribution 2.5 license. Some
|
|
of these icons are used within Overleaf inside the `public/img/silk` and
|
|
`public/brand/icons` directories.
|
|
|
|
#### IconShock icons
|
|
|
|
We gratefully acknowledge [IconShock](http://www.iconshock.com) for use of the icons
|
|
in the `public/img/iconshock` directory found via
|
|
[findicons.com](http://findicons.com/icon/498089/height?id=526085#)
|