Commit graph

7674 commits

Author SHA1 Message Date
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
13e9a25b00
Add how-to-enable-a-service
Like cb520b98, this is meant as a way to shorten all the other pages that need
to enable a service. (i.e. split-gpg-2)
2025-08-21 04:46:06 -04:00
parulin
61bcd9647c
Add a link to glossary in how-to-edit-policy
+ minor spelling edit
2025-08-21 03:56:36 -04:00
parulin
cb520b98b4
Add how-to-edit-a-policy
This is meant as a way to shorten all the other pages that need to
change something to the policies. (i.e. split-gpg-2)
2025-08-21 03:49:46 -04:00
parulin
b6a0aa33c9
Merge remote-tracking branch 'origin/rst' into update-how-to-fullscreen 2025-08-18 17:01:16 -04:00
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
004dc0c5cd
Remove all links pointing to Qubes-Community docs
Most of the links have been replaced by their forum counterpart.
I wasn't able to find a few links like "Template: Ubuntu", so I removed
them, because the link is pointless anyway.
2025-08-18 16:46:25 -04:00
parulin
41fae0f5a4
Use :menuselection: when appropriate 2025-08-18 16:26:35 -04:00
parulin
512525748f
Adding rst_epilog, better markup on some pages
Using more appropriate markup and some substitution, mostly on:

* `how-to-install-software.rst`
* `app-menu-shortcut-troubleshooting.rst`
2025-08-18 16:26:30 -04:00
parulin
edfbaa9649
App menu troubleshooting: Use correct references and markup
Only markup edits, use `:file:`, `:guilabel:`, etc. And add full prompt.
2025-08-18 16:16:21 -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
qubedmaiska
367d5ca10f
Add initial How to edit the rst documentation and rst documentaion style guide docs 2025-08-15 17:26:56 -04:00
qubedmaiska
2d2bcb06a6
Add prompts to all code blocks with bash session 2025-08-15 16:49:01 -04:00
qubedmaiska
b0395e618c
Add 'Edit on GitHub' Link 2025-08-15 16:44:04 -04:00
qubedmaiska
d4e09e079f
Merge remote-tracking branch 'parulin/clean-code-block-console' into rst 2025-08-15 13:57:46 -04:00
qubedmaiska
c093326662
XMerge remote-tracking branch 'parulin/clean-conf-py' into rst 2025-08-14 16:48:28 -04:00
parulin
154e761c3b
Select an OpenGraph image for intro.rst page 2025-08-14 09:35:00 -04:00
parulin
799aa4c0a8
Add sphinxext-opengraph extensions
Fix the opengraph description in forum.qubes-os.org
2025-08-14 08:52:21 -04:00
parulin
43dd7426b1
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-12 09:25:54 -04:00
Andrew David Wong
a82da5bb37
Add supported release information for 4.3 2025-08-11 21:02:40 -07:00
qubedmaiska
6f88e99e28
Merge remote-tracking branch 'parulin/correct-intro' into rst 2025-08-10 18:27:37 -04:00