Skip to content

Latest commit

 

History

History
34 lines (25 loc) · 1.53 KB

CONTRIBUTING.md

File metadata and controls

34 lines (25 loc) · 1.53 KB
Raw

Contributing Guidelines

It is recommended that you use VS Code for this project.

Environment and build instructions

To build and run this project, you will need the following:

  • Node.js
  • PNPM, and then execute the following in the project folder: pnpm install.
  • Emscripten, and make sure that emcc is available in PATH.
    You may also need to change configurations.compilerPath in the .vscode/c_cpp_properties.json file to reflect the location of your Emscripten installation.
  • GNU make, if you're on Windows.
    (Our makefile should work on all desktop platforms regardlessly.)

Then you can run the project by the following:

pnpm start

This will build the project and start the development server.

Project structure

All source codes are located in the src folder, in which you'll find:

  • app: User interface, written in React (I usually use Vue, but I decided to give it a try for this project).
  • core: The C++ part. See change log for the changes made to the original source code of ReferenceFinder.
  • icon: This folder contains the pre-built Font Awesome subset.
  • lib: Compiled WebAssembly of ReferenceFinder.
  • locale: All locale files, based on the previous work by Maya Kraft etc.
  • public: The HTML file and other unbundled assets.