Skip to content

Commit

Permalink
Fix typos and standardise commands
Browse files Browse the repository at this point in the history
  • Loading branch information
carlinmack authored and slint committed Mar 26, 2024
1 parent 39ad055 commit 86ba293
Showing 1 changed file with 38 additions and 30 deletions.
68 changes: 38 additions & 30 deletions docs/getting-started/development-environment.rst
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Setting up your system

The following is a guide to help you prepare your system for developing with
Invenio. A proper development environment setup can save a lot of time and
frustrations. Note that the following guide, is not meant as a guide for
frustrations. Note that the following is not meant as a guide for
setting up servers.

System setup
Expand Down Expand Up @@ -51,7 +51,7 @@ Here are some recommended cask packages (only ``docker`` is required):
**Normal packages**

Normal packages are usually command line tools/libraries that end up in
/usr/local and that you use from the CLI. You can install normal packages
:code:`/usr/local` and that you use from the CLI. You can install normal packages
using the command:

.. code-block:: console
Expand Down Expand Up @@ -89,7 +89,7 @@ Following are CLI tools that are useful during development:
gh # GitHub CLI client (useful e.g for checking out PRs)
gifify # make short screen recordings for bug reports
git # our version control system
hub # extends git with github features
hub # alternative GitHub CLI client
General CLI tools:

Expand All @@ -99,7 +99,7 @@ General CLI tools:
tree # pretty print a directory structure
wget # http client
zsh-completion # if you use zsh as shell
base-completion # if you use bash as shell
bash-completion # if you use bash as shell
CERN specific tools:

Expand All @@ -125,8 +125,7 @@ respectively. Install the following packages:
Once you have installed above packages, you can proceed with installing Python
versions. The following will install Python 3.6, 3.7 and 3.8 and set the
default Python installation to Python 3.8 (node you can always install the
latest patch-level release):
default Python installation to Python 3.8.

.. code-block:: console
Expand All @@ -135,6 +134,12 @@ latest patch-level release):
$ pyenv install 3.8.5
$ pyenv global 3.8.5
Install the latest patch-level release for node.

.. code-block:: console
$ nvm install --lts
You should edit your `.bashrc` or `.zshrc` file to initialise pyenv:

.. code-block:: sh
Expand All @@ -152,7 +157,7 @@ You should edit your `.bashrc` or `.zshrc` file to initialise pyenv:
# pyenv-virtualenvwrapper
pyenv virtualenvwrapper
Now, you can create e.g. Python virtual environments using the following
Now, you can create Python virtual environments using the following
commands:

.. code-block:: console
Expand All @@ -164,15 +169,15 @@ commands:
**Fonts**

In order to create e.g. DOI badges you need the DejaVu Sans font installed.
In order to create DOI badges you need the DejaVu Sans font installed.
Go to https://dejavu-fonts.github.io/ and follow the instructions.

**Docker Desktop for Mac**

You may need to increase the resources assigned to Docker Desktop for Mac
See https://docs.docker.com/docker-for-mac/#resources.

A typical sign of needed more resources, is that services are not running or
Typically this is necessary if services are not running or
images are having problems building.

Ubuntu
Expand All @@ -184,16 +189,16 @@ System setup guide for Ubuntu.

.. code-block:: sh
$ apt install git-all # Distributed version control system
$ apt-get install sqlitebrowser # UI for SQLite
$ snap install spectacle # Organise windows with keyboard shortcuts
$ apt-get install libcairo2-dev # Graphics library
$ apt-get install htop # A better top
$ apt-get install tree # Pretty print a directory structure
$ apt install wget # Http client
$ apt-get install hub # Extends git with github features
$ apt-get install bash-completion # If bash is used as shell
$ apt install sshuttle iptables # Needed for tunneling into CERN.
$ apt install git-all # Distributed version control system
$ apt install sqlitebrowser # UI for SQLite
$ apt install libcairo2-dev # Graphics library
$ apt install htop # A better top
$ apt install tree # Pretty print a directory structure
$ apt install wget # Http client
$ apt install hub # Extends git with github features
$ apt install bash-completion # If bash is used as shell
$ apt install sshuttle iptables # Needed for tunneling into CERN.
$ snap install spectacle # Organise windows with keyboard shortcuts
**Docker**

Expand All @@ -215,7 +220,7 @@ For defining and running multi-container Docker applications.
$ sudo apt install docker-compose
**Google chrome**
**Google Chrome**

Needed for some end-to-end tests.

Expand All @@ -235,26 +240,26 @@ Download the latest OpenShift Origin files. As of this writing, that version num
$ wget https://github.com/openshift/origin/releases/download/v3.11.0/openshift-origin-client-tools-v3.11.0-0cbc58b-linux-64bit.tar.gz
Once the file is downloaded, extract it with the command:
Once the file is downloaded, extract it:

.. code-block:: console
$ tar xvzf openshift*.tar.gz
Change into the newly-created directory with the command:
Change into the newly-created directory:

.. code-block:: console
$ cd openshift-origin-client-tools*/
Move the kubectl and oc binaries with the command:
Move the kubectl and oc binaries:

.. code-block:: console
$ sudo mv oc kubectl /usr/local/bin/
**Installation problems**
If during the installation you encounter broken packages, try the follwoing command:
If during the installation you encounter broken packages, try the following command:

.. code-block:: sh
Expand Down Expand Up @@ -300,9 +305,7 @@ To check if you have the latest version of node installed type the following com

.. code-block:: sh
$ sudo npm cache clean -f
$ sudo npm install -g n
$ sudo n stable
$ nvm use --lts
**Pyenv**

Expand Down Expand Up @@ -347,14 +350,14 @@ https://virtualenv.pypa.io/en/latest/installation.html

**virtualenvwrapper**

Note that after the installation, virtualenvwrapper.sh can be found in ~/.local/bin
Note that after the installation, virtualenvwrapper.sh can be found in :code:`~/.local/bin`

.. code-block::
$ pip3 install --user virtualenvwrapper
Once you have installed above packages, you can proceed with installing Python versions.
The following will install Python 3.6, 3.7 and 3.8 and set the default Python installation to Python 3.8 (node you can always install the latest patch-level release):
The following will install Python 3.6, 3.7 and 3.8 and set the default Python installation to Python 3.8:

.. code-block:: console
Expand All @@ -363,6 +366,11 @@ The following will install Python 3.6, 3.7 and 3.8 and set the default Python in
$ pyenv install 3.8.5
$ pyenv global 3.8.5
Install the latest patch-level release for node.

.. code-block:: console
$ nvm install --lts
You should edit your `.bashrc` or `.zshrc` file to initialise pyenv:

Expand Down Expand Up @@ -424,7 +432,7 @@ editors.
Editors
~~~~~~~
Following editors are used by our existing developers. Don't hesitate to reach
out on our Discord server, to ask for help for useful plugins:
out on our Discord server to ask for help for useful plugins:

- `Emacs <https://www.gnu.org/software/emacs/>`_
- `PyCharm <https://www.jetbrains.com/pycharm/>`_
Expand Down

0 comments on commit 86ba293

Please sign in to comment.