Commit d71913f1 authored by Goutte's avatar Goutte

Add other suggestions of file paths implementation

So far, v3 is my favorite.
parent 990d2a44
...@@ -6,13 +6,7 @@ ...@@ -6,13 +6,7 @@
## Files Paths ## Files Paths
``` Let:
<topic>[/<topic>]/chapter<NN>-<type>.<language>.<format>
or
<topic>[/<topic>]/<NN>-<title>-<type>.<language>.<format>
or
???
```
- `topic`: lowercase alphanumeric topic name (in english, sorry) - `topic`: lowercase alphanumeric topic name (in english, sorry)
- `NN`: level of the course, an integer with always two digits - `NN`: level of the course, an integer with always two digits
...@@ -21,11 +15,53 @@ or ...@@ -21,11 +15,53 @@ or
- `textbook` - `textbook`
- `cheatsheet` (?) - `cheatsheet` (?)
- `annex` - `annex`
- `exercises`
- `language`: 2 letter lowercase language code - `language`: 2 letter lowercase language code
- `format`: `md` for markdown - `format`: `md` for markdown
Let's review our options, now.
## Files Paths v1
```
<topic>[/<topic>]/chapter<NN>-<type>.<language>.<format>
or
<topic>[/<topic>]/<NN>-<title>-<type>.<language>.<format>
or
???
```
## Files Paths v2
```
<N>.<topic>[/<M>.<topic>]/<K>.<slug>/<type>.<language>.<format>
```
Each chapter gets its own directory, which will be simpler for assets organization.
`01.optics/03.the-nature-of-light/textbook.fr.md`
## Files Paths v3
`en/01.optics/03.the-nature-of-light/textbook.md`
`fr/01.optique/03.la-nature-de-la-lumiere/cahier.md`
Pros:
- Everything
Cons:
- Will rely on Ids, so changing them afterwards is fastidious
-> Can be mitigated by initially generating an empty topic dir structure
-----
## Courses Model ## Courses Model
Each Course MUST have: Each Course MUST have:
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment