Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Spell checking README #74

Merged
merged 2 commits into from
Apr 26, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 12 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,31 @@
<img src="./docs/img/logo_esriptorium_tutorial.png" width=500 align="center" alt="eScriptorium Tutorial">

This GitHub repository stores the source code for the [eScriptorium tutorial](https://escriptorium-tutorial.readthedocs.io). It is a collective initiative, open to anyone and designed to be modified by anyone.
This GitHub repository stores the source code for the [eScriptorium tutorial](https://escriptorium-tutorial.readthedocs.io). It is a collective initiative, open to anyone and designed to be modified by anyone.

The eScriptorium Tutorial website is powered by MkDocs and hosted on readthedocs. All the source files of the pages are written in Markdown, which is a light markup language facilitating future editions.
The eScriptorium Tutorial website is powered by MkDocs and hosted on readthedocs. All the source files of the pages are written in Markdown, which is a light markup language facilitating future editions.

For more information on Markdown's syntax, see the cheatsheet. <!-- todo: add link to wiki page -->
For more information on Markdown's syntax, see the [cheat-sheet](https://github.com/alix-tz/escriptorium-tutorial/wiki/Markdown-in-Mkdocs).

## Contribute

Anyone can contribute to this project by:
- listing errors in [a dedicated issues](https://github.com/alix-tz/escriptorium-tutorial/issues/new), preferably offering solutions;

- listing errors in [a dedicated issue](https://github.com/alix-tz/escriptorium-tutorial/issues/new), preferably offering solutions;
- editing the files (see below) and opening pull requests, preferably justifying the necessity of the edition;
- pick up tasks from the issues board, in particular [those tagged with "help wanted"](https://github.com/alix-tz/escriptorium-tutorial/labels/help%20wanted).
- picking up tasks from the issues board, in particular [those tagged with "help wanted"](https://github.com/alix-tz/escriptorium-tutorial/labels/help%20wanted).

Editions can be minor (you spot a missing s, a broken link, etc) or major (an information is out-dated, you want to add a whole new page, etc). Any reasonable modification is welcome, as long as it maintains this documentation up-to-date with the core eScriptorium application.
Editions can be minor (you spot a missing s, a broken link, etc) or major (a piece of information is out-dated, you want to add a whole new page, etc). Any reasonable modification is welcome, as long as it helps keep this documentation up-to-date with the core eScriptorium application.

## Edit the files and run a local test server
## Edit the files and run a local test server

The following steps will allow you to locally test the sucess of the website's build before pushing your modifications to the project.
The following steps will allow you to locally test the success of the website's build before pushing your modifications to the project.

1. Clone this repository and move to the corresponding directory
1. Clone this repository and move to the corresponding directory

``` sh
git clone git@github.com:alix-tz/escriptorium-tutorial.git
cd escriptorium-tutorial/
```
```

2. Create your own local branch

Expand All @@ -35,6 +36,7 @@ git checkout -b my-new-branch
3. Create a **Python 3.8** virtual environment and install mkdocs from requirements

(with conda)

``` sh
conda -n create venv python=3.8
pip install -r requirements.txt
Expand All @@ -51,6 +53,3 @@ Open up [`http://127.0.0.1:8000/`](http://127.0.0.1:8000/) in your browser to se
Note that the local server will automatically reload the content when you save a document.

For more information on how to install and use mkdocs, see [the official documentation](https://www.mkdocs.org/getting-started/).