-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
5c1984d
commit 7f4ba8d
Showing
23 changed files
with
730 additions
and
7 deletions.
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,96 @@ | ||
--- | ||
sidebar_position: 2 | ||
--- | ||
|
||
# Sentences | ||
|
||
Docusaurus can manage multiple versions of your docs. | ||
|
||
|
||
|
||
### Consonants | ||
|
||
Hisyëö has 16 consonants and 1 null consonant which is necessary for the | ||
alphasyllabary but you can optionally include a ⟨ ꞌ ⟩ character in Latin | ||
representations too. | ||
|
||
| Hisyëö | Latin | IPA | Transliteration Sources | | ||
|:-------:|:-----:|:------------:|----------------------------------------------------------------| | ||
| ⟨ɽ⟩ | ⟨ ꞌ ⟩ | / . / | glottal stops & hiatus: ʔ . | | ||
| ⟨ɂ⟩ | ⟨h⟩ | / x / | back fricatives: x χ ʁ ʀ ħ ʕ h ɦ ʢ ʜ | | ||
| ⟨ɔ⟩ | ⟨k⟩ | / k / | voiceless back plosives: k q c | | ||
| ⟨ꜿ⟩ | ⟨g⟩ | / g / | voiced back plosives: g ɢ ʡ ɣ | | ||
| ⟨c⟩ | ⟨ t ⟩ | / t / | voiceless front plosives: t ʈ | | ||
| ⟨ꞇ⟩ | ⟨z⟩ | / t͡ɕ / | voiceless affricates: t͡s t͡ʃ t͡ɕ ʈ͡ʂ ɧ | | ||
| ⟨ɐ⟩ | ⟨s⟩ | / s / | alveolar sibilants: s z | | ||
| ⟨ɋ⟩ | ⟨x⟩ | / ʃ / | palatal fricatives: ʃ ʒ ʂ ʐ ç ɕ ʑ | | ||
| ⟨ʌ⟩ | ⟨d⟩ | / d / | voiced alveolar plosives: d ɖ | | ||
| ⟨ⱴ⟩ | ⟨ ȷ ⟩ | / d͡ʑ / | voiced affricates: d͡z d͡ʒ d͡ʑ ɖ͡ʐ ɟ | | ||
| ⟨ʋ⟩ | ⟨p⟩ | / p / | labial plosives: b p | | ||
| ⟨ɤ⟩ | ⟨v⟩ | / v / | labio-dental fricatives: ɸ β f v θ ð | | ||
| ⟨ƶ⟩ | ⟨m⟩ | / m / | labial nasals: m ɱ | | ||
| ⟨ƨ⟩ | ⟨n⟩ | / n / | other nasals: n ɳ ɲ ŋ ɴ | | ||
| ⟨ʒ⟩ | ⟨w⟩ | / w / | labial approximants: w ɥ ʋ | | ||
| ⟨ʓ⟩ | ⟨ l ⟩ | / l / | alve./retro approx./taps/trills: ɹ ɻ l ɭ ɺ ɬ ɮ r ɾ ɽ | | ||
| ⟨ɀ⟩ | ⟨y⟩ | / j / | patalal/velar approximants: j ʝ ʎ ɰ ʟ | | ||
|
||
### Vowels | ||
|
||
| Hisyëö | Latin | IPA | Transliteration Sources | | ||
|:---:|:---:|-----|----------------------------------------------| | ||
| | ⟨o⟩ | /ɑ/ | unrounded open vowels: a ɑ ɐ | | ||
| ⟨ ı ⟩ | ⟨ö⟩ | /o/ | rounded open/back vowels: ɶ ɒ ɞ ɔ o ɵ | | ||
| ⟨ ʃ ⟩ | ⟨u⟩ | /ə/ | unrounded central/back open-mid vowels: ə ʌ ɤ | | ||
| ⟨ ʄ ⟩ | ⟨ü⟩ | /u/ | close back vowels: u ʉ ʊ ɯ | | ||
| ⟨ ȷ ⟩ | ⟨ı⟩ | /ɪ/ | front/central close/close-mid vowels: ɪ ʏ ɨ | | ||
| ⟨ ɟ ⟩ | ⟨i⟩ | /i/ | front/central close vowels: i y | | ||
| ⟨ ɿ ⟩ | ⟨e⟩ | /ɛ/ | unrounded open-mid vowels: ɛ ɜ æ | | ||
| ⟨ ʇ ⟩ | ⟨ë⟩ | /e/ | front/central close-mid vowels: e ɘ ø | | ||
|
||
## Create a docs version | ||
|
||
Release a version 1.0 of your project: | ||
|
||
```bash | ||
npm run docusaurus docs:version 1.0 | ||
``` | ||
|
||
The `docs` folder is copied into `versioned_docs/version-1.0` and `versions.json` is created. | ||
|
||
Your docs now have 2 versions: | ||
|
||
- `1.0` at `http://localhost:3000/docs/` for the version 1.0 docs | ||
- `current` at `http://localhost:3000/docs/next/` for the **upcoming, unreleased docs** | ||
|
||
## Add a Version Dropdown | ||
|
||
To navigate seamlessly across versions, add a version dropdown. | ||
|
||
Modify the `docusaurus.config.js` file: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
themeConfig: { | ||
navbar: { | ||
items: [ | ||
// highlight-start | ||
{ | ||
type: 'docsVersionDropdown', | ||
}, | ||
// highlight-end | ||
], | ||
}, | ||
}, | ||
}; | ||
``` | ||
|
||
The docs version dropdown appears in your navbar: | ||
|
||
![Docs Version Dropdown](./img/docsVersionDropdown.png) | ||
|
||
## Update an existing version | ||
|
||
It is possible to edit versioned docs in their respective folder: | ||
|
||
- `versioned_docs/version-1.0/hello.md` updates `http://localhost:3000/docs/hello` | ||
- `docs/hello.md` updates `http://localhost:3000/docs/next/hello` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
{ | ||
"label": "Word Types", | ||
"position": 1, | ||
"link": { | ||
"type": "generated-index" | ||
} | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,88 @@ | ||
--- | ||
sidebar_position: 5 | ||
--- | ||
|
||
# Connectors | ||
|
||
Let's translate `docs/intro.md` to French. | ||
|
||
## Configure i18n | ||
|
||
Modify `docusaurus.config.js` to add support for the `fr` locale: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
i18n: { | ||
defaultLocale: 'en', | ||
locales: ['en', 'fr'], | ||
}, | ||
}; | ||
``` | ||
|
||
## Translate a doc | ||
|
||
Copy the `docs/intro.md` file to the `i18n/fr` folder: | ||
|
||
```bash | ||
mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ | ||
|
||
cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md | ||
``` | ||
|
||
Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. | ||
|
||
## Start your localized site | ||
|
||
Start your site on the French locale: | ||
|
||
```bash | ||
npm run start -- --locale fr | ||
``` | ||
|
||
Your localized site is accessible at [http://localhost:3000/fr/](http://localhost:3000/fr/) and the `Getting Started` page is translated. | ||
|
||
:::caution | ||
|
||
In development, you can only use one locale at a same time. | ||
|
||
::: | ||
|
||
## Add a Locale Dropdown | ||
|
||
To navigate seamlessly across languages, add a locale dropdown. | ||
|
||
Modify the `docusaurus.config.js` file: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
themeConfig: { | ||
navbar: { | ||
items: [ | ||
// highlight-start | ||
{ | ||
type: 'localeDropdown', | ||
}, | ||
// highlight-end | ||
], | ||
}, | ||
}, | ||
}; | ||
``` | ||
|
||
The locale dropdown now appears in your navbar: | ||
|
||
![Locale Dropdown](./img/localeDropdown.png) | ||
|
||
## Build your localized site | ||
|
||
Build your site for a specific locale: | ||
|
||
```bash | ||
npm run build -- --locale fr | ||
``` | ||
|
||
Or build your site to include all the locales at once: | ||
|
||
```bash | ||
npm run build | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,88 @@ | ||
--- | ||
sidebar_position: 4 | ||
--- | ||
|
||
# Determiners | ||
|
||
Let's translate `docs/intro.md` to French. | ||
|
||
## Configure i18n | ||
|
||
Modify `docusaurus.config.js` to add support for the `fr` locale: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
i18n: { | ||
defaultLocale: 'en', | ||
locales: ['en', 'fr'], | ||
}, | ||
}; | ||
``` | ||
|
||
## Translate a doc | ||
|
||
Copy the `docs/intro.md` file to the `i18n/fr` folder: | ||
|
||
```bash | ||
mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ | ||
|
||
cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md | ||
``` | ||
|
||
Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. | ||
|
||
## Start your localized site | ||
|
||
Start your site on the French locale: | ||
|
||
```bash | ||
npm run start -- --locale fr | ||
``` | ||
|
||
Your localized site is accessible at [http://localhost:3000/fr/](http://localhost:3000/fr/) and the `Getting Started` page is translated. | ||
|
||
:::caution | ||
|
||
In development, you can only use one locale at a same time. | ||
|
||
::: | ||
|
||
## Add a Locale Dropdown | ||
|
||
To navigate seamlessly across languages, add a locale dropdown. | ||
|
||
Modify the `docusaurus.config.js` file: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
themeConfig: { | ||
navbar: { | ||
items: [ | ||
// highlight-start | ||
{ | ||
type: 'localeDropdown', | ||
}, | ||
// highlight-end | ||
], | ||
}, | ||
}, | ||
}; | ||
``` | ||
|
||
The locale dropdown now appears in your navbar: | ||
|
||
![Locale Dropdown](./img/localeDropdown.png) | ||
|
||
## Build your localized site | ||
|
||
Build your site for a specific locale: | ||
|
||
```bash | ||
npm run build -- --locale fr | ||
``` | ||
|
||
Or build your site to include all the locales at once: | ||
|
||
```bash | ||
npm run build | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,88 @@ | ||
--- | ||
sidebar_position: 6 | ||
--- | ||
|
||
# Enders | ||
|
||
Let's translate `docs/intro.md` to French. | ||
|
||
## Configure i18n | ||
|
||
Modify `docusaurus.config.js` to add support for the `fr` locale: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
i18n: { | ||
defaultLocale: 'en', | ||
locales: ['en', 'fr'], | ||
}, | ||
}; | ||
``` | ||
|
||
## Translate a doc | ||
|
||
Copy the `docs/intro.md` file to the `i18n/fr` folder: | ||
|
||
```bash | ||
mkdir -p i18n/fr/docusaurus-plugin-content-docs/current/ | ||
|
||
cp docs/intro.md i18n/fr/docusaurus-plugin-content-docs/current/intro.md | ||
``` | ||
|
||
Translate `i18n/fr/docusaurus-plugin-content-docs/current/intro.md` in French. | ||
|
||
## Start your localized site | ||
|
||
Start your site on the French locale: | ||
|
||
```bash | ||
npm run start -- --locale fr | ||
``` | ||
|
||
Your localized site is accessible at [http://localhost:3000/fr/](http://localhost:3000/fr/) and the `Getting Started` page is translated. | ||
|
||
:::caution | ||
|
||
In development, you can only use one locale at a same time. | ||
|
||
::: | ||
|
||
## Add a Locale Dropdown | ||
|
||
To navigate seamlessly across languages, add a locale dropdown. | ||
|
||
Modify the `docusaurus.config.js` file: | ||
|
||
```js title="docusaurus.config.js" | ||
module.exports = { | ||
themeConfig: { | ||
navbar: { | ||
items: [ | ||
// highlight-start | ||
{ | ||
type: 'localeDropdown', | ||
}, | ||
// highlight-end | ||
], | ||
}, | ||
}, | ||
}; | ||
``` | ||
|
||
The locale dropdown now appears in your navbar: | ||
|
||
![Locale Dropdown](./img/localeDropdown.png) | ||
|
||
## Build your localized site | ||
|
||
Build your site for a specific locale: | ||
|
||
```bash | ||
npm run build -- --locale fr | ||
``` | ||
|
||
Or build your site to include all the locales at once: | ||
|
||
```bash | ||
npm run build | ||
``` |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Oops, something went wrong.