Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/engineer-man/emkc
Engineer Man Knowledge Center
https://github.com/engineer-man/emkc
bootstrap4 elasticsearch mysql nodejs redis
Last synced: 8 days ago
JSON representation
Engineer Man Knowledge Center
- Host: GitHub
- URL: https://github.com/engineer-man/emkc
- Owner: engineer-man
- License: mit
- Created: 2018-09-07T01:29:36.000Z (over 6 years ago)
- Default Branch: develop
- Last Pushed: 2023-11-10T06:25:16.000Z (about 1 year ago)
- Last Synced: 2024-12-08T23:40:49.641Z (19 days ago)
- Topics: bootstrap4, elasticsearch, mysql, nodejs, redis
- Language: JavaScript
- Homepage: https://emkc.org
- Size: 7 MB
- Stars: 139
- Watchers: 17
- Forks: 34
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
## Engineer Man Knowledge Center (emkc)
This is the official repo and project for the Engineer Man Knowledge Center. The official deployment of this project
is located at https://emkc.org. Be sure to familiarize yourself with the contribution guidelines and project license
if you plan to use this software.
#### Install Instructions
Docker is the preferred (and only supported) way to work with EMKC in development. EMKC is known to work on all
Linux/macOS machines and Windows machines running either WSL or natively with Windows 10 Pro.
- `git clone https://github.com/engineer-man/emkc`
- `cd emkc`
- `./emkc init`
- `./emkc start`
- `./emkc rmig migrate`
- `./emkc stop` when done.
- `./emkc` to view a list of commands.
Once started, you can access the local version of the site at http://127.0.0.1:2005 (localhost:2005 for WSL).
> **Note:** when using WSL, it is recommended to use the linux filesystem for better performance and fewer errors; however if you intend to use the windows filesystem, make sure to mount your windows volumes with metadata options since the MySQL Docker Container needs permissions to modify files in the volume. You can configure that automatically on WSL startup by adding `options = "metadata"` to /etc/wsl.conf under the [automount]
> section (check https://devblogs.microsoft.com/commandline/automatically-configuring-wsl/)
#### Local Config
There are two files needed to configure the application. Make sure to modify these with your own values. If
these files are not present, navigate to the project root and run `./emkc init`.
- App: `platform/config/local.js`
- DB Migrations: `platform/migrations/config.json`
#### Contribution Guidelines
All contributions are reviewed to make sure they work, fit well with the design, and fit well with
the established code. BDFL is [realtux](https://github.com/realtux) who will do a final review and merge
to master and deploy.
- Review the issues on GitHub and grab whichever you feel most comfortable doing
- Place code on a branch other than master/develop (Fork for non-org developers)
- Follow the style that is generally present with the project (details below)
- Use established tech in place (Bootstrap 4, React, etc.)
- Test to make sure everything works
#### General Code Guidelines
- Prefer spaces over tabs
- 120 character max line length for source
- PascalCase for classes, snake_case for everything else
- Use ES9 to the fullest extent possible
- Single quotes only
- In general just make code look like everything else
#### License
Engineer Man Knowledge Center is licensed under the permissive MIT license. License details can be found
in the `license` file in the root of the project.