iDempiere Documentation

This website is built using Docusaurus 2, a modern static website generator.

Documentation Contribute

There are some ways to edit this site:

1. Through the github interface.
2. Through the source code at local.
3. Through the online service like Stackblitz

Since most users cannot directly commit to the repository, you will need to perform a pull request to perform edits.

GitHub Pages does not allow direct editing from rendered site pages. This process is easy when editing from the GitHub web interface. Below is how it works in GitHub.

If you wish to download and modify the source code, you will need to fork, modify and create a pull request. This process is discussed below.

Github Interface

You are welcome to perform basic edits by following the steps outlined below:

1. Navigate to the documentation home page: https://github.com/idempiere/idempiere.github.io

2. Click the edit button shown in the image below:

3. This button creates a fork of the repository linked to your personal github account, and opens the file you indicated you wish to edit. Add the edits you wish to make to the documentation, and click on the green "Commit changes..." button as shown in the image below:

4. Copilot will generate a commit message for your edits. Click "Proceed" to accept the edits, and commit them to your forked repository:

5. Github will display all the changes you have committed. Confirm the changes you are proposing, and click "Create Pull Request". Provide a name for the pull request, and write down a summary of the pull request and click "Create Pull Request".

Source Code At Local

If you wish to make and test local edits, use the following instructions:

# setup workspace, just do one time
sudo apt update
sudo apt install git
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
nvm list-remote
nvm install v18.16.0
git clone https://github.com/idempiere/idempiere.github.io
cd idempiere.github.io/
npm install
npm start #builds and launches the site locally

Want to edit documents on "idempiere.github.io/docs" and see your changes instantly in the browser? Here's how:

1. Runnpm start
2. Open the document in your preferred text editor. edit and save it

Now, any edits you make will be auto reflected live in the browser (without you need to do F5)!

Online service like Stackblitz

1. To get started, open StackBlitz and sign in using your GitHub account
2. Visit repositories and select 'idempiere.github.io'
3. StackBlitz offers a cloud-based Node.js development environment with a Visual Studio Code interface. This allows you to write and run Node.js without installing anything on your machine (actual it install to browse through webcontainers)
4. This feature allows for simultaneous document editing and live preview updates. You can even open the live preview in a separate browser tab
5. The tool also allows you to perform Git operations

Internationalization and Translation

The purpose of this section is to offer a cheatsheet for adding an new locale and translations. Here are the details:

• Start with thedocusaurus internationalization introduction and 3 sub-pages.
• Quick notes:
  • Modify docusaurus.config.js to include yourdesired locale (example: locales: ['en', 'fr', 'fa'],)
  • Run the command to write the translation details
    • npm run write-translations -- --locale es
  • Assuming you are manually translating your document (not using Crowdin), execute the mkdir/copy statements from here:
  • https://docusaurus.io/docs/i18n/git
  • Start translating...
  • Note: copying over the files to be translated is essentially like forking the documentation. It is recommended that you wait until the English docs are near-complete before copying over the content to minimize syncing efforts for future edits.