-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
3 changed files
with
28 additions
and
18 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 |
---|---|---|
|
@@ -7,43 +7,47 @@ Enigma machine emulator for the Web. The emulator is faithful to the workings of | |
|
||
I highly recommend checking out the [Enigma Operator's Field Manual](https://github.com/lubeskih/enigma-simulator/blob/master/docs/EOFM.md) before using the emulator. | ||
|
||
### Screenshot | ||
|
||
![Enigma](src/misc/ss.png) | ||
![Enigma](src/misc/enigma.gif) | ||
|
||
### Starting the emulator | ||
|
||
Clone the repository: | ||
##### Cloning the repository | ||
|
||
`git clone https://github.com/lubeskih/enigma-emulator.git && cd enigma-emulator` | ||
|
||
Then install the packages by entering: | ||
##### Installing required packages | ||
|
||
`yarn install` | ||
|
||
Starting the emulator can be done with: | ||
##### Running the emulator | ||
|
||
`yarn start` | ||
|
||
### Navigating around the repository | ||
|
||
- `src` - Main source directory | ||
- `src/components` - React components | ||
- `constants` - Enigma constats (e.g. Enigma wiring, turnovers etc...) | ||
- `enigma-logic` - Files that hold the main logic behind the Enigma (stepping, turnover etc..) behind the rotors, reflectors, stators etc... | ||
- `misc` - misc | ||
- `store` - MobX store files used in the project | ||
- `types` - Interfaces/Types used in the project | ||
- `src/constants` - Constant variables used around the project (e.g. Enigma wiring, turnovers etc...) | ||
- `src/enigma-logic` - Files that hold the main logic behind the Enigma (stepping, turnover etc..) behind the rotors, reflectors, stators etc... | ||
- `src/misc` - Misc | ||
- `src/store` - MobX store files | ||
- `src/types` - Interfaces/Types used in the project | ||
|
||
### Reporting an issue | ||
### Contributing | ||
|
||
Use GitHub's issue system to report an issue (emulator logic error, manual typo etc...). | ||
Although I consider this project finished, contributions are more than welcome. | ||
|
||
### Contributing | ||
If you want to contribute, start with opening an issue before writing the code so we can first discuss the idea. | ||
|
||
If everything goes well, you are free to open a PR, but please don't forget to include details about your changes. | ||
|
||
### Reporting an issue | ||
|
||
If you want to report an issue, please use GitHub's issue system. | ||
|
||
Contributions are more than welcome. | ||
### Contact | ||
|
||
If you want to contribute, start with opening an issue before writing the code so we can first discuss the idea. If everything goes well, you are free to open a PR, but please don't forget to include details about your changes. | ||
Drop me a line or two at `[email protected]`, phone would be easier if you have my number. | ||
|
||
### License | ||
|
||
|
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
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.