parulin
8436e2ac9f
Create a real Sphinx glossary
2025-09-06 12:09:48 +02:00
qubedmaiska
ff68e782c8
Merge branch 'code_block_prompts_full' into rst
2025-09-06 06:04:30 -04:00
qubedmaiska
6218ea2dce
Merge remote-tracking branch 'parulin/warning-fix' into rst
2025-09-06 05:42:29 -04:00
qubedmaiska
a1e57134ef
add __pycache__ to gitignore for safe local sphinx-autobuild(s)
2025-09-06 05:39:59 -04:00
qubedmaiska
a0cace3d78
Merge remote-tracking branch 'parulin/add-opengraph-extension' into rst
2025-09-06 04:24:42 -04:00
parulin
250a9b0500
Add a default Opengraph image + an empty alt
2025-08-31 14:12:04 -04:00
qubedmaiska
d05bb2b25b
merge changes from pr #1508 excluding admin-api (only spaces in diff)
2025-08-27 00:33:39 -04:00
parulin
36d69d40c8
Merge remote-tracking branch 'upstream/rst' into add-opengraph-extension
2025-08-26 01:53:31 -04:00
parulin
11b2626fa2
Merge branch 'rst' into paragraphs-workaround-2
2025-08-26 05:50:29 +00:00
parulin
b02eba099e
Fix of tables options and emphasis
2025-08-26 01:43:59 -04:00
parulin
3121b4bc85
Merge remote-tracking branch 'upstream/rst' into paragraphs-workaround-2
2025-08-26 01:21:20 -04:00
qubedmaiska
49138e68f0
fixed errors with pygments's highlighting
2025-08-24 16:59:25 -04:00
Rusty Bird
5912b172a2
How to use disposables: qvm-run -> qvm-run-vm
...
https://forum.qubes-os.org/t/how-to-make-qvm-run-available-in-debian-templates/35252/3
2025-08-24 08:32:21 +00:00
qubedmaiska
7e76afb1a4
Fixes to code block pygemnt's highlighting, add __pychache__ to gitignore
...
add prompts to terminal sessions where needed
2025-08-23 18:50:45 -04:00
qubedmaiska
9bd5e20bfd
Merge remote-tracking branch 'parulin/html-theme' into rst
2025-08-23 17:40:02 -04:00
Tobias Killer
3e683cda68
Add newlines where present in Markdown version
2025-08-23 11:31:46 +02:00
Tobias Killer
140789e7fc
Merge branch 'rst' into toki_fix_findings
2025-08-23 11:05:37 +02:00
qubedmaiska
44dbd11d12
Merge remote-tracking branch 'alimirjamali/issue-10070-r4_3-release-notes' into rst
2025-08-22 17:38:36 -04:00
andrewdavidwong
e726b8ce67
Add warning about AI hallucinations
2025-08-22 17:27:53 -04:00
andrewdavidwong
613db1847a
Add Fedora 42 to supported templates
...
QubesOS/qubes-issues#9807
2025-08-22 17:23:27 -04:00
andrewdavidwong
1eea1244d3
Update guidelines for duplicate issues
...
Per @marmarek's request in https://github.com/QubesOS/qubes-issues/issues/2229#issuecomment-3110186417 , do not reopen old feature requests the initial implementation of which was completed successfully.
2025-08-22 17:16:08 -04:00
Ali Mirjamali
d0f91e88db
Qubes OS r4.3 release notes
...
resolves: https://github.com/QubesOS/qubes-issues/issues/10070
2025-08-22 20:17:30 +03:30
parulin
06c6503932
Fixing various warnings from sphinx-build
...
* missing theme options in conf.py
* orphaned pages are tagged as such
* a markup mistake
* duplicate labels
* a code-block marked as python code
2025-08-18 16:52:34 -04:00
parulin
f3f96daf78
Merge remote-tracking branch 'upstream/rst' into html-theme
2025-08-18 12:00:59 -04:00
parulin
08672d43c1
Restoring @andrewdavidwong commit
...
I previously erased these edits ...
This restores a82da5bb37
2025-08-18 03:18:34 -04:00
parulin
dbbed6af86
Restoring Fedora and Debian instructions
...
Fixing a previous mistake.
2025-08-18 03:10:23 -04:00
qubedmaiska
40a836603a
Merge remote-tracking branch 'origin/supported-release-4.3' into rst
2025-08-17 15:26:24 -04:00
parulin
1154873370
Merge branch 'rst' into paragraphs-workaround-2
2025-08-16 14:37:18 -04:00
parulin
5281f045dc
Trying to fix my mistakes ...
2025-08-16 14:28:31 -04:00
qubedmaiska
def5eec5c9
Extract session comments into instructions
2025-08-16 14:23:13 -04:00
qubedmaiska
49c9f9c11c
Remove obsolete prompts, extract session comments to instructions
2025-08-16 14:23:11 -04:00
qubedmaiska
43493b38e6
Add prompts to all code blocks with bash session
2025-08-16 14:23:09 -04:00
qubedmaiska
6c987d00d4
Add 'Edit on GitHub' Link
2025-08-16 14:23:07 -04:00
parulin
651229c10d
Change again some languages
...
Thanks to @tokideveloper !!!
2025-08-16 14:23:06 -04:00
parulin
bffc808d0a
Two code-block language mistakes
2025-08-16 14:23:04 -04:00
parulin
483fce4c63
Minor cleaning of code highlighting
...
* Most of text blocks are in fact output blocks
* On qubes-iso-building.rst, try to get something correct for console
lines starting with a comment
* Fixing a wrong :menuselection: item.
Statistics:
685 console
79 text
44 bash
35 output
16 yaml
9 systemd
9 c
8 python
4 ini
4 doscon
2 markdown
2 desktop
1 xorg.conf
1 xml+jinja
1 xml
1 kconfig
1 html
2025-08-16 14:23:02 -04:00
parulin
0ff244e167
Correct code-block lexers
...
Changing `bash` lexer to `console` because it is appropriate most of
the time. Then after a manual review, some lexer have been changed.
I used `text` each time I was unsure, and for prompt outputs.
The page `/developer/building/qubes-iso-building.rst` still need to be
reviewed (look for lines starting with `$ #`).
I'm not sure about the Windows pages, should we use
[doscon](https://pygments.org/docs/lexers/#pygments.lexers.shell.MSDOSSessionLexer )
or `powershell`?
Is there an appropriate lexer for `guid.conf` content?
**Statistics - Before**
870 bash
9 python
9 c
2 yaml
**Statistics - After**
684 console
111 text
44 bash
16 yaml
9 systemd
9 c
8 python
4 ini
4 doscon
2 markdown
2 desktop
1 xorg.conf
1 xml+jinja
1 xml
1 kconfig
1 html
This suggests that the default lexer should be `console`.
2025-08-16 14:23:00 -04:00
parulin
fa7a62b529
Use console lexer instead of bash with a prompt
2025-08-16 14:22:55 -04:00
parulin
d541882733
Revert some configuration options
...
* reuse html builder
* rename videos extension to youtube_frame
* remove HTML body max/min parameters
* remove reference to release number in HTML title
2025-08-16 14:22:31 -04:00
parulin
f5a660954d
Ignore the _build directory
2025-08-16 14:22:29 -04:00
parulin
2531253dce
Add minimal configuration for linkcheck builder
...
* Avoid checking .onion domains.
* Do not download links to check anchors
2025-08-16 14:22:26 -04:00
parulin
4ebc721ef8
Cleanup sphinx and readthedocs configurations
...
* Use dirhtml as default builder for readthedocs (clean URLs)
* The configuration variables are now sorted with respect to the Sphinx
documentation
* Remove useless comments in conf.py
* Add new comments for each section, following Sphinx documentation
order
* The code corresponding to videos have been moved from config to a
dedicated extension.
* Use proper HTML theme options
* Exclude all files starting with `.`, `_` (sphinx convention)
* Use OpenSearch
2025-08-16 14:22:24 -04:00
parulin
acc9a5f27d
Fix Xen link on intro.rst
2025-08-16 14:22:23 -04:00
parulin
1f331a4f00
Introduction: correct an image position
2025-08-16 14:22:21 -04:00
parulin
4fa0d293bd
Remove duplicate captions and wrong alt formatting of images
2025-08-16 14:22:17 -04:00
Marek Marczykowski-Górecki
9e5fa7a387
ci: remove gitlab ci
...
RTD provides own CI service
2025-08-16 14:22:16 -04:00
Tobias Killer
cad541c3af
Merge branch 'rst' into toki_fix_findings
2025-08-16 20:05:30 +02:00
parulin
1cc1b6efac
Merge branch 'rst' into add-opengraph-extension
2025-08-16 15:10:45 +00:00
qubedmaiska
e3e699fa5e
Extract session comments into instructions
2025-08-16 09:31:12 -04:00
qubedmaiska
f96169ba0e
Remove obsolete prompts, extract session comments to instructions
2025-08-16 09:17:57 -04:00
