jzohrab / lute-manual Goto Github PK

Dicts have changed quite a lot, docs should change.

https://jzohrab.github.io/lute-manual/usage/languages/dictionaries.html

I kept clicking and dragging the playback speed button but it didn't so anything. I had to search the Discord to find you had to scroll while hovering over it.

Clarifying this in the docs would be useful.

Currently, the manual uses various github user content and github assets files for image sources. The images were copied-pasted into github issues, and then the resulting urls were copied into the .md files.

This will cause problems when the manual is moved to the new LuteOrg repo, because those old assets can disappear. The images should just be committed to this repo. Bloat, who cares, it's clearer.

For the images to work with both local mdbook build and gh pages deployment, the image source should be committed to src/assets, and then the images referred to by relative paths, e.g, from project root:

$ ls src/assets/
testit.png

$ cat src/install/install.md 
# Installation
...
![image](../assets/testit.png)

When this is done, the local site should be fine even if wifi is turned off.

• ./SUMMARY.md
• ./intro.md
• ./404.md
• ./background.md
• ./misc/changelog.md
• ./misc/doc-feedback.md
• ./misc/backlog.md
• ./install/troubleshooting.md
• ./install/beta-releases.md
• ./install/install.md
• ./install/windows/windows-10-32-bit-using-python.md
• ./install/windows/windows-using-docker.md
• ./install/windows/index.md
• ./install/mecab.md
• ./faq/import-from-other-systems.md
• ./faq/v2-to-v3.md
• ./faq/free.md
• ./faq/prioritizing-dev-work.md
• ./faq/terms/sentences-only-shown-when-page-is-read.md
• ./faq/terms/terms-cannot-be-changed-once-created.md
• ./faq/terms/term-statuses.md
• ./faq/setup/usb.md
• ./faq/setup/web-server.md
• ./faq/language/dict-not-working.md
• ./faq/language/add-a-language.md
• ./faq/books/pdf-import.md
• ./faq/books/finding-stuff.md
• ./faq/books/utf-8.md
• ./faq/books/epub-import.md
• ./faq/help.md
• ./faq/online-lute.md
• ./faq/why-no-flashcards.md
• ./faq/adding-basic-auth.md
• ./usage/reading/overlapping-terms.md
• ./usage/reading/tutorial.md
• ./usage/reading/reading.md
• ./usage/terms/link-parent-child-statuses.md
• ./usage/terms/parent-terms.md
• ./usage/terms/bulk-term-import.md
• ./usage/terms/terms.md
• ./usage/audio.md
• ./usage/updating.md
• ./usage/books/stats.md
• ./usage/books/creating-books.md
• ./usage/languages/dictionaries.md
• ./usage/languages/defining-languages.md
• ./usage/languages/word-characters.md
• ./usage/starting-and-stopping.md
• ./usage/command-line-jobs.md
• ./usage/themes/toggling-highlights.md
• ./usage/themes/themes.md
• ./usage/themes/custom-styles.md
• ./usage/keyboard-bindings.md
• ./backup/restore.md
• ./backup/backup.md
• commit all images, fix all pages
• check local site displays correctly when wifi is turned off
• push, check all pages once published

Manual should mention that users can set a term to have multiple parents when bulk importing terms with a csv by comma separating the parents within double quotes

Jz just a small error, in the updating lute page when it says "First, you must stop Lute", I tried to open that link but it returns, "Document not found (404)"


Thanks ;)