mirror of
https://github.com/ankitects/anki.git
synced 2026-07-28 14:58:56 -04:00
fb0215a2c1
## Summary - add a generated `docs-site/` Mintlify proof of concept for a unified Anki docs site - migrate the desktop manual, AnkiMobile docs, FAQs, add-on docs, translation docs, release notes, legacy docs, and repo-local Sphinx/MyST developer docs into the POC tree - add a migration helper that preserves mdBook ordering, handles common MDX incompatibilities, and regenerates the landing-page-inspired Mintlify styling - apply minimal styling based on the current Anki landing page: Anki logo, Hanken Grotesk, blue primary color, subtle surfaces, and compact nav treatment ## Validation - `uv run --with ty ty check tools/mintlify_poc_migrate.py` - `source ~/.nvm/nvm.sh && nvm use 22.15.0 && mint validate` - previewed locally with `mint dev --port 3000` and checked the home page/developer docs in browser ## Notes This is intentionally a draft POC. It does not remove the existing Sphinx or mdBook docs flows yet; it demonstrates what bringing the sources into this repo and building from a single Mintlify root could look like. --------- Co-authored-by: Andrew Sanchez <andrewsanchez@users.noreply.github.com> Co-authored-by: Luc Mcgrady <lucmcgrady@gmail.com> Co-authored-by: Abdo <abdo@abdnh.net>
46 lines
1.3 KiB
Plaintext
46 lines
1.3 KiB
Plaintext
---
|
|
title: "Running from Python"
|
|
---
|
|
|
|
If you experience startup problems or crashes with the packaged builds of Anki
|
|
that you are unable to resolve, you can try running directly via Python as a
|
|
last resort.
|
|
|
|
The instructions below are provided for Windows users, as these problems seem
|
|
most prevalent on Windows, but a similar approach can be taken on other
|
|
platforms too.
|
|
|
|
1. Install [https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe](https://www.python.org/ftp/python/3.9.13/python-3.9.13-amd64.exe). Customize
|
|
the install location, and choose `c:\python`
|
|
2. Open the Start menu, and open a Command Prompt.
|
|
3. Type in the following and hit enter:
|
|
|
|
```
|
|
\python\python -m venv \anki-venv
|
|
```
|
|
|
|
4. And then the following, which will take a while:
|
|
|
|
```
|
|
\anki-venv\scripts\pip install aqt orjson pyqt6-webengine
|
|
```
|
|
|
|
5. Finally:
|
|
|
|
```
|
|
\anki-venv\scripts\anki
|
|
```
|
|
|
|
If that solves your problem, you can start Anki again in the future by repeating
|
|
steps 2 and 5.
|
|
|
|
If you still experience problems, you can try changing the Qt version:
|
|
|
|
```
|
|
\anki-venv\scripts\pip install pyqt5==5.15 pyqtwebengine==5.15.0
|
|
```
|
|
|
|
If that does not help either, and you have already followed all the steps on
|
|
[when problems occur](./when-problems-occur), then you may unfortunately be
|
|
out of luck.
|