engineer-man/emkc

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 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.