docs: premium UI improvements — navbar links, hover effects, inline tips, accordion troubleshooting (#646)

- Move Discord, GitHub, PyPI, and Follow on X links from sidebar anchors to top-right navbar
- Lock dark mode as default via appearance.strict and hide theme toggle
- Add custom.css with hover highlighting for tables, code blocks, cards, callouts, and inline code
- Move all Tips and Common Pitfalls sections inline next to their relevant content across all 25 reference docs
- Polish context.md: remove duplicates, condense callouts, upgrade Cookbooks to CardGroup
- Convert Troubleshooting and Performance Optimization sections in installation.md, cli-setup.md, explorer-setup.md, learning-more.md, and faq.md from plain headers to AccordionGroup
- Change navigation-hint Tip callouts to Info in concepts.md, faq.md, glossary.md, and modules.md
This commit is contained in:
Mohd Kaif
2026-06-17 18:59:25 +05:30
committed by GitHub
parent a326c7d3bd
commit e04dc12e6e
30 changed files with 723 additions and 593 deletions
+26 -10
View File
@@ -120,50 +120,66 @@ pip install git+https://github.com/semantica-agi/semantica.git@main
## Troubleshooting
### ModuleNotFoundError
<AccordionGroup>
Make sure you're in the right environment:
<Accordion title="ModuleNotFoundError: No module named 'semantica'" icon="circle-xmark">
Make sure you're in the right virtual environment:
```bash
pip list | grep semantica
pip install --upgrade semantica
```
### Installation fails with dependency errors
</Accordion>
<Accordion title="Installation fails with dependency errors" icon="triangle-exclamation">
```bash
pip install --upgrade pip
pip install build wheel
pip install semantica --no-deps # install without optional deps first
pip install semantica --no-deps # install core first, then add extras
```
### GPU dependencies fail
</Accordion>
Install CPU-only first, then add GPU support:
<Accordion title="GPU dependencies fail to install" icon="bolt">
Install CPU-only first, then layer in GPU support:
```bash
pip install semantica
pip install semantica[gpu]
```
### Permission denied
</Accordion>
<Accordion title="Permission denied" icon="lock">
```bash
pip install --user semantica # or use a virtual environment
```
### Windows `[all]` install fails
</Accordion>
This was fixed in **v0.5.0**. Upgrade to the latest release:
<Accordion title="Windows [all] install fails" icon="windows">
Fixed in **v0.5.0**. Upgrade to the latest release:
```bash
pip install --upgrade semantica
```
### Windows PyTorch DLL errors
</Accordion>
<Accordion title="Windows PyTorch DLL errors on startup" icon="windows">
Install the [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe). This is a Windows system dependency, not a Semantica bug.
</Accordion>
</AccordionGroup>
## Next Steps