Step 1: Get the code into IntelliJ
Start IntelliJ.
IntelliJ shows the following window:
![IntelliJ Start Window](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/guidelines-intellij-start-window.png)
Click on “Open”
Choose build.gradle
in the root of the jabref source folder:
![Open File or Project dialog](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/guidelines-intellij-choose-build-gradle.png)
build.gradle
in the “Open Project or File” dialogAfter pressing “OK”, IntelliJ asks how that file should be opened. Answer: “Open as Project”
![Open Project dialog](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/guidelines-choose-open-as-project.png)
Then, trust the project:
![Trust and Open Project dialog](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/guidelines-trust-project.png)
Ensure that committing via IntelliJ works
IntelliJ offers committing using the UI. Press Alt+0 to open the commit dialog.
Unfortunately, IntelliJ has no support for ignored sub modules [IDEA-285237]. Fortunately, there is a workaround:
Go to File > Settings… > Version Control > Directory Mappings.
Currently, it looks as follows:
![Directory Mappings including sub modules](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/intellij-directory-mappings-unmodified.png)
You need to tell IntelliJ to ignore the submodules buildres\abbrv.jabref.org
, src\main\resources\csl-locales
, and src\main\resources\csl-styles
. Select all three (holding the Ctrl key). Then press the red minus button on top.
This will make these directories “Unregistered roots:”, which is fine.
![Directory Mappings having three repositories unregsitered](/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/intellij-directory-mappings-unregistered-roots.png)