Add language selection for docs, and Add UI py typer

fastapi · Jan 10, 2023 · df84ec2 · df84ec2
1 parent 7b3148c
commit df84ec2
Show file tree

Hide file tree

Showing 161 changed files with 1,068 additions and 605 deletions.
diff --git a/docs/en/data/external_links.yml b/docs/en/data/external_links.yml
diff --git a/docs/en/data/github_sponsors.yml b/docs/en/data/github_sponsors.yml
diff --git a/docs/en/data/people.yml b/docs/en/data/people.yml
diff --git a/docs/en/data/sponsors.yml b/docs/en/data/sponsors.yml
diff --git a/docs/en/data/sponsors_badge.yml b/docs/en/data/sponsors_badge.yml
diff --git a/docs/advanced/decimal.md → docs/en/docs/advanced/decimal.md b/docs/advanced/decimal.md → docs/en/docs/advanced/decimal.md
@@ -36,7 +36,7 @@ When you use `condecimal()` you can specify the number of digits and decimal pla
 Let's say that each hero in the database will have an amount of money. We could make that field a `Decimal` type using the `condecimal()` function:
 
 ```{.python .annotate hl_lines="12" }
-{!./docs_src/advanced/decimal/tutorial001.py[ln:1-12]!}
+{!../../docs_src/advanced/decimal/tutorial001.py[ln:1-12]!}
 
 # More code here later 👇
 ```
@@ -45,7 +45,7 @@ Let's say that each hero in the database will have an amount of money. We could
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/advanced/decimal/tutorial001.py!}
+{!../../docs_src/advanced/decimal/tutorial001.py!}
 ```
 
 </details>
@@ -82,7 +82,7 @@ When creating new models you can actually pass normal (`float`) numbers, Pydanti
 ```Python hl_lines="4-6"
 # Code above omitted 👆
 
-{!./docs_src/advanced/decimal/tutorial001.py[ln:25-35]!}
+{!../../docs_src/advanced/decimal/tutorial001.py[ln:25-35]!}
 
 # Code below omitted 👇
 ```
@@ -91,7 +91,7 @@ When creating new models you can actually pass normal (`float`) numbers, Pydanti
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/advanced/decimal/tutorial001.py!}
+{!../../docs_src/advanced/decimal/tutorial001.py!}
 ```
 
 </details>
@@ -103,7 +103,7 @@ Then, when working with Decimal types, you can confirm that they indeed avoid th
 ```Python hl_lines="15-16"
 # Code above omitted 👆
 
-{!./docs_src/advanced/decimal/tutorial001.py[ln:38-51]!}
+{!../../docs_src/advanced/decimal/tutorial001.py[ln:38-51]!}
 
 # Code below omitted 👇
 ```
@@ -112,7 +112,7 @@ Then, when working with Decimal types, you can confirm that they indeed avoid th
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/advanced/decimal/tutorial001.py!}
+{!../../docs_src/advanced/decimal/tutorial001.py!}
 ```
 
 </details>

diff --git a/docs/advanced/index.md → docs/en/docs/advanced/index.md b/docs/advanced/index.md → docs/en/docs/advanced/index.md
diff --git a/docs/alternatives.md → docs/en/docs/alternatives.md b/docs/alternatives.md → docs/en/docs/alternatives.md
diff --git a/docs/contributing.md → docs/en/docs/contributing.md b/docs/contributing.md → docs/en/docs/contributing.md
@@ -76,7 +76,7 @@ Many of the tutorials have blocks of code.
 
 In most of the cases, these blocks of code are actual complete applications that can be run as is.
 
-In fact, those blocks of code are not written inside the Markdown, they are Python files in the `./docs_src/` directory.
+In fact, those blocks of code are not written inside the Markdown, they are Python files in the `../../docs_src/` directory.
 
 And those Python files are included/injected in the documentation when generating the site.
 

diff --git a/docs/css/custom.css → docs/en/docs/css/custom.css b/docs/css/custom.css → docs/en/docs/css/custom.css
diff --git a/docs/css/termynal.css → docs/en/docs/css/termynal.css b/docs/css/termynal.css → docs/en/docs/css/termynal.css
diff --git a/docs/databases.md → docs/en/docs/databases.md b/docs/databases.md → docs/en/docs/databases.md
diff --git a/docs/db-to-code.md → docs/en/docs/db-to-code.md b/docs/db-to-code.md → docs/en/docs/db-to-code.md
diff --git a/docs/features.md → docs/en/docs/features.md b/docs/features.md → docs/en/docs/features.md
diff --git a/docs/help.md → docs/en/docs/help.md b/docs/help.md → docs/en/docs/help.md
diff --git a/...db-and-table-with-db-browser/image001.png → ...db-and-table-with-db-browser/image001.png b/...db-and-table-with-db-browser/image001.png → ...db-and-table-with-db-browser/image001.png
diff --git a/...db-and-table-with-db-browser/image002.png → ...db-and-table-with-db-browser/image002.png b/...db-and-table-with-db-browser/image002.png → ...db-and-table-with-db-browser/image002.png
diff --git a/...db-and-table-with-db-browser/image003.png → ...db-and-table-with-db-browser/image003.png b/...db-and-table-with-db-browser/image003.png → ...db-and-table-with-db-browser/image003.png
diff --git a/...db-and-table-with-db-browser/image004.png → ...db-and-table-with-db-browser/image004.png b/...db-and-table-with-db-browser/image004.png → ...db-and-table-with-db-browser/image004.png
diff --git a/...db-and-table-with-db-browser/image005.png → ...db-and-table-with-db-browser/image005.png b/...db-and-table-with-db-browser/image005.png → ...db-and-table-with-db-browser/image005.png
diff --git a/...db-and-table-with-db-browser/image006.png → ...db-and-table-with-db-browser/image006.png b/...db-and-table-with-db-browser/image006.png → ...db-and-table-with-db-browser/image006.png
diff --git a/...db-and-table-with-db-browser/image007.png → ...db-and-table-with-db-browser/image007.png b/...db-and-table-with-db-browser/image007.png → ...db-and-table-with-db-browser/image007.png
diff --git a/...db-and-table-with-db-browser/image008.png → ...db-and-table-with-db-browser/image008.png b/...db-and-table-with-db-browser/image008.png → ...db-and-table-with-db-browser/image008.png
diff --git a/...db-and-table-with-db-browser/image009.png → ...db-and-table-with-db-browser/image009.png b/...db-and-table-with-db-browser/image009.png → ...db-and-table-with-db-browser/image009.png
diff --git a/...db-and-table-with-db-browser/image010.png → ...db-and-table-with-db-browser/image010.png b/...db-and-table-with-db-browser/image010.png → ...db-and-table-with-db-browser/image010.png
diff --git a/...g/create-db-and-table/inline-errors01.png → ...g/create-db-and-table/inline-errors01.png b/...g/create-db-and-table/inline-errors01.png → ...g/create-db-and-table/inline-errors01.png
diff --git a/docs/img/databases/external-server.drawio → ...docs/img/databases/external-server.drawio b/docs/img/databases/external-server.drawio → ...docs/img/databases/external-server.drawio
diff --git a/docs/img/databases/external-server.svg → ...en/docs/img/databases/external-server.svg b/docs/img/databases/external-server.svg → ...en/docs/img/databases/external-server.svg
diff --git a/docs/img/databases/multiple-servers.drawio → ...ocs/img/databases/multiple-servers.drawio b/docs/img/databases/multiple-servers.drawio → ...ocs/img/databases/multiple-servers.drawio
diff --git a/docs/img/databases/multiple-servers.svg → ...n/docs/img/databases/multiple-servers.svg b/docs/img/databases/multiple-servers.svg → ...n/docs/img/databases/multiple-servers.svg
diff --git a/docs/img/databases/relationships.drawio → ...n/docs/img/databases/relationships.drawio b/docs/img/databases/relationships.drawio → ...n/docs/img/databases/relationships.drawio
diff --git a/docs/img/databases/relationships.svg → docs/en/docs/img/databases/relationships.svg b/docs/img/databases/relationships.svg → docs/en/docs/img/databases/relationships.svg
diff --git a/docs/img/databases/same-server.drawio → .../en/docs/img/databases/same-server.drawio b/docs/img/databases/same-server.drawio → .../en/docs/img/databases/same-server.drawio
diff --git a/docs/img/databases/same-server.svg → docs/en/docs/img/databases/same-server.svg b/docs/img/databases/same-server.svg → docs/en/docs/img/databases/same-server.svg
diff --git a/docs/img/databases/single-file.drawio → .../en/docs/img/databases/single-file.drawio b/docs/img/databases/single-file.drawio → .../en/docs/img/databases/single-file.drawio
diff --git a/docs/img/databases/single-file.svg → docs/en/docs/img/databases/single-file.svg b/docs/img/databases/single-file.svg → docs/en/docs/img/databases/single-file.svg
diff --git a/docs/img/db-to-code/autocompletion01.png → .../docs/img/db-to-code/autocompletion01.png b/docs/img/db-to-code/autocompletion01.png → .../docs/img/db-to-code/autocompletion01.png
diff --git a/docs/img/db-to-code/mapper.drawio → docs/en/docs/img/db-to-code/mapper.drawio b/docs/img/db-to-code/mapper.drawio → docs/en/docs/img/db-to-code/mapper.drawio
diff --git a/docs/img/db-to-code/mapper.svg → docs/en/docs/img/db-to-code/mapper.svg b/docs/img/db-to-code/mapper.svg → docs/en/docs/img/db-to-code/mapper.svg
diff --git a/docs/img/favicon.png → docs/en/docs/img/favicon.png b/docs/img/favicon.png → docs/en/docs/img/favicon.png
diff --git a/docs/img/features/autocompletion01.png → ...en/docs/img/features/autocompletion01.png b/docs/img/features/autocompletion01.png → ...en/docs/img/features/autocompletion01.png
diff --git a/docs/img/github-social-preview.png → docs/en/docs/img/github-social-preview.png b/docs/img/github-social-preview.png → docs/en/docs/img/github-social-preview.png
diff --git a/docs/img/github-social-preview.svg → docs/en/docs/img/github-social-preview.svg b/docs/img/github-social-preview.svg → docs/en/docs/img/github-social-preview.svg
diff --git a/docs/img/icon-white.svg → docs/en/docs/img/icon-white.svg b/docs/img/icon-white.svg → docs/en/docs/img/icon-white.svg
diff --git a/docs/img/icon.svg → docs/en/docs/img/icon.svg b/docs/img/icon.svg → docs/en/docs/img/icon.svg
diff --git a/docs/img/index/autocompletion01.png → docs/en/docs/img/index/autocompletion01.png b/docs/img/index/autocompletion01.png → docs/en/docs/img/index/autocompletion01.png
diff --git a/docs/img/index/autocompletion02.png → docs/en/docs/img/index/autocompletion02.png b/docs/img/index/autocompletion02.png → docs/en/docs/img/index/autocompletion02.png
diff --git a/docs/img/index/inline-errors01.png → docs/en/docs/img/index/inline-errors01.png b/docs/img/index/inline-errors01.png → docs/en/docs/img/index/inline-errors01.png
diff --git a/docs/img/logo-margin/logo-margin-vector.svg → ...cs/img/logo-margin/logo-margin-vector.svg b/docs/img/logo-margin/logo-margin-vector.svg → ...cs/img/logo-margin/logo-margin-vector.svg
diff --git a/docs/img/logo-margin/logo-margin.svg → docs/en/docs/img/logo-margin/logo-margin.svg b/docs/img/logo-margin/logo-margin.svg → docs/en/docs/img/logo-margin/logo-margin.svg
diff --git a/docs/img/tutorial/delete/image01.png → docs/en/docs/img/tutorial/delete/image01.png b/docs/img/tutorial/delete/image01.png → docs/en/docs/img/tutorial/delete/image01.png
diff --git a/...rial/fastapi/limit-and-offset/image01.png → ...rial/fastapi/limit-and-offset/image01.png b/...rial/fastapi/limit-and-offset/image01.png → ...rial/fastapi/limit-and-offset/image01.png
diff --git a/...orial/fastapi/multiple-models/image01.png → ...orial/fastapi/multiple-models/image01.png b/...orial/fastapi/multiple-models/image01.png → ...orial/fastapi/multiple-models/image01.png
diff --git a/...orial/fastapi/multiple-models/image02.png → ...orial/fastapi/multiple-models/image02.png b/...orial/fastapi/multiple-models/image02.png → ...orial/fastapi/multiple-models/image02.png
diff --git a/...orial/fastapi/multiple-models/image03.png → ...orial/fastapi/multiple-models/image03.png b/...orial/fastapi/multiple-models/image03.png → ...orial/fastapi/multiple-models/image03.png
diff --git a/...img/tutorial/fastapi/read-one/image01.png → ...img/tutorial/fastapi/read-one/image01.png b/...img/tutorial/fastapi/read-one/image01.png → ...img/tutorial/fastapi/read-one/image01.png
diff --git a/...utorial/fastapi/relationships/image01.png → ...utorial/fastapi/relationships/image01.png b/...utorial/fastapi/relationships/image01.png → ...utorial/fastapi/relationships/image01.png
diff --git a/...utorial/fastapi/relationships/image02.png → ...utorial/fastapi/relationships/image02.png b/...utorial/fastapi/relationships/image02.png → ...utorial/fastapi/relationships/image02.png
diff --git a/...utorial/fastapi/relationships/image03.png → ...utorial/fastapi/relationships/image03.png b/...utorial/fastapi/relationships/image03.png → ...utorial/fastapi/relationships/image03.png
diff --git a/...utorial/fastapi/relationships/image04.png → ...utorial/fastapi/relationships/image04.png b/...utorial/fastapi/relationships/image04.png → ...utorial/fastapi/relationships/image04.png
diff --git a/...torial/fastapi/response-model/image01.png → ...torial/fastapi/response-model/image01.png b/...torial/fastapi/response-model/image01.png → ...torial/fastapi/response-model/image01.png
diff --git a/...torial/fastapi/response-model/image02.png → ...torial/fastapi/response-model/image02.png b/...torial/fastapi/response-model/image02.png → ...torial/fastapi/response-model/image02.png
diff --git a/...fastapi/simple-hero-api/db-browser-01.png → ...fastapi/simple-hero-api/db-browser-01.png b/...fastapi/simple-hero-api/db-browser-01.png → ...fastapi/simple-hero-api/db-browser-01.png
diff --git a/...orial/fastapi/simple-hero-api/image01.png → ...orial/fastapi/simple-hero-api/image01.png b/...orial/fastapi/simple-hero-api/image01.png → ...orial/fastapi/simple-hero-api/image01.png
diff --git a/...orial/fastapi/simple-hero-api/image02.png → ...orial/fastapi/simple-hero-api/image02.png b/...orial/fastapi/simple-hero-api/image02.png → ...orial/fastapi/simple-hero-api/image02.png
diff --git a/docs/img/tutorial/fastapi/teams/image01.png → ...cs/img/tutorial/fastapi/teams/image01.png b/docs/img/tutorial/fastapi/teams/image01.png → ...cs/img/tutorial/fastapi/teams/image01.png
diff --git a/...img/tutorial/indexes/dictionary001.drawio → ...img/tutorial/indexes/dictionary001.drawio b/...img/tutorial/indexes/dictionary001.drawio → ...img/tutorial/indexes/dictionary001.drawio
diff --git a/docs/img/tutorial/indexes/dictionary001.svg → ...cs/img/tutorial/indexes/dictionary001.svg b/docs/img/tutorial/indexes/dictionary001.svg → ...cs/img/tutorial/indexes/dictionary001.svg
diff --git a/...img/tutorial/indexes/dictionary002.drawio → ...img/tutorial/indexes/dictionary002.drawio b/...img/tutorial/indexes/dictionary002.drawio → ...img/tutorial/indexes/dictionary002.drawio
diff --git a/docs/img/tutorial/indexes/dictionary002.svg → ...cs/img/tutorial/indexes/dictionary002.svg b/docs/img/tutorial/indexes/dictionary002.svg → ...cs/img/tutorial/indexes/dictionary002.svg
diff --git a/...img/tutorial/indexes/dictionary003.drawio → ...img/tutorial/indexes/dictionary003.drawio b/...img/tutorial/indexes/dictionary003.drawio → ...img/tutorial/indexes/dictionary003.drawio
diff --git a/docs/img/tutorial/indexes/dictionary003.svg → ...cs/img/tutorial/indexes/dictionary003.svg b/docs/img/tutorial/indexes/dictionary003.svg → ...cs/img/tutorial/indexes/dictionary003.svg
diff --git a/...img/tutorial/indexes/dictionary004.drawio → ...img/tutorial/indexes/dictionary004.drawio b/...img/tutorial/indexes/dictionary004.drawio → ...img/tutorial/indexes/dictionary004.drawio
diff --git a/docs/img/tutorial/indexes/dictionary004.svg → ...cs/img/tutorial/indexes/dictionary004.svg b/docs/img/tutorial/indexes/dictionary004.svg → ...cs/img/tutorial/indexes/dictionary004.svg
diff --git a/...img/tutorial/indexes/dictionary005.drawio → ...img/tutorial/indexes/dictionary005.drawio b/...img/tutorial/indexes/dictionary005.drawio → ...img/tutorial/indexes/dictionary005.drawio
diff --git a/docs/img/tutorial/indexes/dictionary005.svg → ...cs/img/tutorial/indexes/dictionary005.svg b/docs/img/tutorial/indexes/dictionary005.svg → ...cs/img/tutorial/indexes/dictionary005.svg
diff --git a/...img/tutorial/indexes/dictionary006.drawio → ...img/tutorial/indexes/dictionary006.drawio b/...img/tutorial/indexes/dictionary006.drawio → ...img/tutorial/indexes/dictionary006.drawio
diff --git a/docs/img/tutorial/indexes/dictionary006.svg → ...cs/img/tutorial/indexes/dictionary006.svg b/docs/img/tutorial/indexes/dictionary006.svg → ...cs/img/tutorial/indexes/dictionary006.svg
diff --git a/...img/tutorial/indexes/dictionary007.drawio → ...img/tutorial/indexes/dictionary007.drawio b/...img/tutorial/indexes/dictionary007.drawio → ...img/tutorial/indexes/dictionary007.drawio
diff --git a/docs/img/tutorial/indexes/dictionary007.svg → ...cs/img/tutorial/indexes/dictionary007.svg b/docs/img/tutorial/indexes/dictionary007.svg → ...cs/img/tutorial/indexes/dictionary007.svg
diff --git a/...img/tutorial/indexes/dictionary008.drawio → ...img/tutorial/indexes/dictionary008.drawio b/...img/tutorial/indexes/dictionary008.drawio → ...img/tutorial/indexes/dictionary008.drawio
diff --git a/docs/img/tutorial/indexes/dictionary008.svg → ...cs/img/tutorial/indexes/dictionary008.svg b/docs/img/tutorial/indexes/dictionary008.svg → ...cs/img/tutorial/indexes/dictionary008.svg
diff --git a/docs/img/tutorial/indexes/techbook001.drawio → ...s/img/tutorial/indexes/techbook001.drawio b/docs/img/tutorial/indexes/techbook001.drawio → ...s/img/tutorial/indexes/techbook001.drawio
diff --git a/docs/img/tutorial/indexes/techbook001.svg → ...docs/img/tutorial/indexes/techbook001.svg b/docs/img/tutorial/indexes/techbook001.svg → ...docs/img/tutorial/indexes/techbook001.svg
diff --git a/docs/img/tutorial/insert/image01.png → docs/en/docs/img/tutorial/insert/image01.png b/docs/img/tutorial/insert/image01.png → docs/en/docs/img/tutorial/insert/image01.png
diff --git a/docs/img/tutorial/insert/image02.png → docs/en/docs/img/tutorial/insert/image02.png b/docs/img/tutorial/insert/image02.png → docs/en/docs/img/tutorial/insert/image02.png
diff --git a/docs/img/tutorial/insert/image03.png → docs/en/docs/img/tutorial/insert/image03.png b/docs/img/tutorial/insert/image03.png → docs/en/docs/img/tutorial/insert/image03.png
diff --git a/...tutorial/many-to-many/many-to-many.drawio → ...tutorial/many-to-many/many-to-many.drawio b/...tutorial/many-to-many/many-to-many.drawio → ...tutorial/many-to-many/many-to-many.drawio
diff --git a/...mg/tutorial/many-to-many/many-to-many.svg → ...mg/tutorial/many-to-many/many-to-many.svg b/...mg/tutorial/many-to-many/many-to-many.svg → ...mg/tutorial/many-to-many/many-to-many.svg
diff --git a/.../tutorial/offset-and-limit/db-browser.png → .../tutorial/offset-and-limit/db-browser.png b/.../tutorial/offset-and-limit/db-browser.png → .../tutorial/offset-and-limit/db-browser.png
diff --git a/...mg/tutorial/offset-and-limit/limit.drawio → ...mg/tutorial/offset-and-limit/limit.drawio b/...mg/tutorial/offset-and-limit/limit.drawio → ...mg/tutorial/offset-and-limit/limit.drawio
diff --git a/docs/img/tutorial/offset-and-limit/limit.svg → ...s/img/tutorial/offset-and-limit/limit.svg b/docs/img/tutorial/offset-and-limit/limit.svg → ...s/img/tutorial/offset-and-limit/limit.svg
diff --git a/...g/tutorial/offset-and-limit/limit2.drawio → ...g/tutorial/offset-and-limit/limit2.drawio b/...g/tutorial/offset-and-limit/limit2.drawio → ...g/tutorial/offset-and-limit/limit2.drawio
diff --git a/.../img/tutorial/offset-and-limit/limit2.svg → .../img/tutorial/offset-and-limit/limit2.svg b/.../img/tutorial/offset-and-limit/limit2.svg → .../img/tutorial/offset-and-limit/limit2.svg
diff --git a/...g/tutorial/offset-and-limit/limit3.drawio → ...g/tutorial/offset-and-limit/limit3.drawio b/...g/tutorial/offset-and-limit/limit3.drawio → ...g/tutorial/offset-and-limit/limit3.drawio
diff --git a/.../img/tutorial/offset-and-limit/limit3.svg → .../img/tutorial/offset-and-limit/limit3.svg b/.../img/tutorial/offset-and-limit/limit3.svg → .../img/tutorial/offset-and-limit/limit3.svg
diff --git a/...ionships/attributes/back-populates.drawio → ...ionships/attributes/back-populates.drawio b/...ionships/attributes/back-populates.drawio → ...ionships/attributes/back-populates.drawio
diff --git a/...lationships/attributes/back-populates.svg → ...lationships/attributes/back-populates.svg b/...lationships/attributes/back-populates.svg → ...lationships/attributes/back-populates.svg
diff --git a/...onships/attributes/back-populates2.drawio → ...onships/attributes/back-populates2.drawio b/...onships/attributes/back-populates2.drawio → ...onships/attributes/back-populates2.drawio
diff --git a/...ationships/attributes/back-populates2.svg → ...ationships/attributes/back-populates2.svg b/...ationships/attributes/back-populates2.svg → ...ationships/attributes/back-populates2.svg
diff --git a/...tutorial/relationships/select/image01.png → ...tutorial/relationships/select/image01.png b/...tutorial/relationships/select/image01.png → ...tutorial/relationships/select/image01.png
diff --git a/...tutorial/relationships/select/image02.png → ...tutorial/relationships/select/image02.png b/...tutorial/relationships/select/image02.png → ...tutorial/relationships/select/image02.png
diff --git a/...tutorial/relationships/select/image03.png → ...tutorial/relationships/select/image03.png b/...tutorial/relationships/select/image03.png → ...tutorial/relationships/select/image03.png
diff --git a/...elationships/select/relationships2.drawio → ...elationships/select/relationships2.drawio b/...elationships/select/relationships2.drawio → ...elationships/select/relationships2.drawio
diff --git a/...l/relationships/select/relationships2.svg → ...l/relationships/select/relationships2.svg b/...l/relationships/select/relationships2.svg → ...l/relationships/select/relationships2.svg
diff --git a/docs/img/tutorial/select/image01.png → docs/en/docs/img/tutorial/select/image01.png b/docs/img/tutorial/select/image01.png → docs/en/docs/img/tutorial/select/image01.png
diff --git a/docs/img/tutorial/update/image01.png → docs/en/docs/img/tutorial/update/image01.png b/docs/img/tutorial/update/image01.png → docs/en/docs/img/tutorial/update/image01.png
diff --git a/docs/img/tutorial/where/image01.png → docs/en/docs/img/tutorial/where/image01.png b/docs/img/tutorial/where/image01.png → docs/en/docs/img/tutorial/where/image01.png
diff --git a/docs/index.md → docs/en/docs/index.md b/docs/index.md → docs/en/docs/index.md
diff --git a/docs/js/custom.js → docs/en/docs/js/custom.js b/docs/js/custom.js → docs/en/docs/js/custom.js
diff --git a/docs/js/termynal.js → docs/en/docs/js/termynal.js b/docs/js/termynal.js → docs/en/docs/js/termynal.js
diff --git a/docs/release-notes.md → docs/en/docs/release-notes.md b/docs/release-notes.md → docs/en/docs/release-notes.md
diff --git a/docs/tutorial/automatic-id-none-refresh.md → ...ocs/tutorial/automatic-id-none-refresh.md b/docs/tutorial/automatic-id-none-refresh.md → ...ocs/tutorial/automatic-id-none-refresh.md
@@ -9,7 +9,7 @@ But the same `id` field actually **can be `None`** in the Python code, so we dec
 ```Python hl_lines="4"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:6-10]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:6-10]!}
 
 # Code below omitted 👇
 ```
@@ -18,7 +18,7 @@ But the same `id` field actually **can be `None`** in the Python code, so we dec
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -34,7 +34,7 @@ When we create a new `Hero` instance, we don't set the `id`:
 ```Python hl_lines="3-6"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-26]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-26]!}
 
 # Code below ommitted 👇
 ```
@@ -43,7 +43,7 @@ When we create a new `Hero` instance, we don't set the `id`:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -77,7 +77,7 @@ We can confirm that by printing our heroes before adding them to the database:
 ```Python hl_lines="9-11"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-31]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-31]!}
 
 # Code below omitted 👇
 ```
@@ -86,7 +86,7 @@ We can confirm that by printing our heroes before adding them to the database:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -123,7 +123,7 @@ We can verify by creating a session using a `with` block and adding the objects.
 ```Python hl_lines="19-21"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-41]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:23-41]!}
 
 # Code below ommitted 👇
 ```
@@ -132,7 +132,7 @@ We can verify by creating a session using a `with` block and adding the objects.
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -163,7 +163,7 @@ Then we can `commit` the changes in the session, and print again:
 ```Python hl_lines="13  16-18"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-48]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-48]!}
 
 # Code below omitted 👇
 ```
@@ -172,7 +172,7 @@ Then we can `commit` the changes in the session, and print again:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -236,7 +236,7 @@ To confirm and understand how this **automatic expiration and refresh** of data
 ```Python hl_lines="21-23  26-28"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-58]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-58]!}
 
 # Code below ommitted 👇
 ```
@@ -245,7 +245,7 @@ To confirm and understand how this **automatic expiration and refresh** of data
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -333,7 +333,7 @@ You can do that too with `session.refresh(object)`:
 ```Python hl_lines="30-32  35-37"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-67]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-67]!}
 
 # Code below ommitted 👇
 ```
@@ -342,7 +342,7 @@ You can do that too with `session.refresh(object)`:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -406,7 +406,7 @@ There are no surprises here, it still works:
 ```Python hl_lines="40-42"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-72]!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py[ln:33-72]!}
 
 # Code below omitted 👇
 ```
@@ -415,7 +415,7 @@ There are no surprises here, it still works:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial001.py!}
 ```
 
 </details>
@@ -451,10 +451,10 @@ Now let's review all this code once again.
     And as we created the **engine** with `echo=True`, we can see the SQL statements being executed at each step.
 
 ```{ .python .annotate }
-{!./docs_src/tutorial/automatic_id_none_refresh/tutorial002.py!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/tutorial002.py!}
 ```
 
-{!./docs_src/tutorial/automatic_id_none_refresh/annotations/en/tutorial002.md!}
+{!../../docs_src/tutorial/automatic_id_none_refresh/annotations/en/tutorial002.md!}
 
 And here's all the output generated by running this program, all together:
 

diff --git a/docs/tutorial/code-structure.md → docs/en/docs/tutorial/code-structure.md b/docs/tutorial/code-structure.md → docs/en/docs/tutorial/code-structure.md
@@ -68,7 +68,7 @@ We can use these relative imports because, for example, in the file `app.py` (th
 You could put all the database Models in a single Python module (a single Python file), for example `models.py`:
 
 ```Python
-{!./docs_src/tutorial/code_structure/tutorial001/models.py!}
+{!../../docs_src/tutorial/code_structure/tutorial001/models.py!}
 ```
 
 This way, you wouldn't have to deal with circular imports for other models.
@@ -80,7 +80,7 @@ And then you could import the models from this file/module in any other file/mod
 Then you could put the code creating the **engine** and the function to create all the tables (if you are not using migrations) in another file `database.py`:
 
 ```Python
-{!./docs_src/tutorial/code_structure/tutorial001/database.py!}
+{!../../docs_src/tutorial/code_structure/tutorial001/database.py!}
 ```
 
 This file would also be imported by your application code, to use the shared **engine** and to get and call the function `create_db_and_tables()`.
@@ -90,7 +90,7 @@ This file would also be imported by your application code, to use the shared **e
 Finally, you could put the code to create the **app** in another file `app.py`:
 
 ```Python hl_lines="3-4"
-{!./docs_src/tutorial/code_structure/tutorial001/app.py!}
+{!../../docs_src/tutorial/code_structure/tutorial001/app.py!}
 ```
 
 Here we import the models, the engine, and the function to create all the tables and then we can use them all internally.
@@ -205,7 +205,7 @@ So, we can use it in an `if` block and import things inside the `if` block. And
 Using that trick of `TYPE_CHECKING` we can "import" the `Team` in `hero_model.py`:
 
 ```Python hl_lines="1  5-6  16"
-{!./docs_src/tutorial/code_structure/tutorial002/hero_model.py!}
+{!../../docs_src/tutorial/code_structure/tutorial002/hero_model.py!}
 ```
 
 Have in mind that now we *have* to put the annotation of `Team` as a string: `"Team"`, so that Python doesn't have errors at runtime.
@@ -215,7 +215,7 @@ Have in mind that now we *have* to put the annotation of `Team` as a string: `"T
 We use the same trick in the `team_model.py` file:
 
 ```Python hl_lines="1  5-6  14"
-{!./docs_src/tutorial/code_structure/tutorial002/team_model.py!}
+{!../../docs_src/tutorial/code_structure/tutorial002/team_model.py!}
 ```
 
 Now we get editor support, autocompletion, inline errors, and **SQLModel** keeps working. 🎉
@@ -225,7 +225,7 @@ Now we get editor support, autocompletion, inline errors, and **SQLModel** keeps
 Now, just for completeness, the `app.py` file would import the models from both modules:
 
 ```Python hl_lines="4-5  10  12-14"
-{!./docs_src/tutorial/code_structure/tutorial002/app.py!}
+{!../../docs_src/tutorial/code_structure/tutorial002/app.py!}
 ```
 
 And of course, all the tricks with `TYPE_CHECKING` and type annotations in strings are **only needed in the files with circular imports**.

diff --git a/...tutorial/connect/create-connected-rows.md → ...tutorial/connect/create-connected-rows.md b/...tutorial/connect/create-connected-rows.md → ...tutorial/connect/create-connected-rows.md
@@ -46,7 +46,7 @@ We will continue with the code in the previous example and we will add more thin
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/create_tables/tutorial001.py!}
+{!../../docs_src/tutorial/connect/create_tables/tutorial001.py!}
 ```
 
 </details>
@@ -64,7 +64,7 @@ Let's start by creating two teams:
 ```Python hl_lines="3-9"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/connect/insert/tutorial001.py[ln:31-37]!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py[ln:31-37]!}
 
 # Code below omitted 👇
 ```
@@ -73,7 +73,7 @@ Let's start by creating two teams:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/insert/tutorial001.py!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py!}
 ```
 
 </details>
@@ -95,7 +95,7 @@ Let's not forget to add this function `create_heroes()` to the `main()` function
 ```Python hl_lines="5"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/connect/insert/tutorial001.py[ln:63-65]!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py[ln:63-65]!}
 
 # Code below omitted 👇
 ```
@@ -104,7 +104,7 @@ Let's not forget to add this function `create_heroes()` to the `main()` function
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/insert/tutorial001.py!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py!}
 ```
 
 </details>
@@ -143,7 +143,7 @@ As the `Hero` class model now has a field (column, attribute) `team_id`, we can
 ```Python hl_lines="12"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/connect/insert/tutorial001.py[ln:31-41]!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py[ln:31-41]!}
 
 # Code below omitted 👇
 ```
@@ -152,7 +152,7 @@ As the `Hero` class model now has a field (column, attribute) `team_id`, we can
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/insert/tutorial001.py!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py!}
 ```
 
 </details>
@@ -182,7 +182,7 @@ Let's now create two more heroes:
 ```Python hl_lines="14-20"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/connect/insert/tutorial001.py[ln:31-52]!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py[ln:31-52]!}
 
 # Code below omitted 👇
 ```
@@ -191,7 +191,7 @@ Let's now create two more heroes:
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/insert/tutorial001.py!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py!}
 ```
 
 </details>
@@ -228,7 +228,7 @@ Now let's refresh and print those new heroes to see their new ID pointing to the
 ```Python hl_lines="26-28  30-32"
 # Code above omitted 👆
 
-{!./docs_src/tutorial/connect/insert/tutorial001.py[ln:31-60]!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py[ln:31-60]!}
 
 # Code below omitted 👇
 ```
@@ -237,7 +237,7 @@ Now let's refresh and print those new heroes to see their new ID pointing to the
 <summary>👀 Full file preview</summary>
 
 ```Python
-{!./docs_src/tutorial/connect/insert/tutorial001.py!}
+{!../../docs_src/tutorial/connect/insert/tutorial001.py!}
 ```
 
 </details>