Commit graph

7684 commits

Author SHA1 Message Date
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
qubedmaiska
a60be307bb
Merge remote-tracking branch 'parulin/migration-alt-captions' into rst 2025-08-10 18:20:29 -04:00
parulin
c5a053d12e
Fix missing cell in table 2025-08-09 17:58:19 -04:00
parulin
db47feb239
Fix some missing code blocks inside lists 2025-08-09 17:58:19 -04:00
parulin
8489fcc4fa
Migration: fix indented lists and raw html tables
All raw directives have been removed or replaced by reStructuredText
list-tables.
2025-08-09 17:58:19 -04:00
parulin
3ba7a492f0
Change again some languages
Thanks to @tokideveloper !!!
2025-08-09 17:39:16 -04:00
Tobias Killer
9bd6e80ad7 Improve linking to a section 2025-08-09 22:31:45 +02:00
Tobias Killer
0cfd755295 Fix formattings and other issues
See issue 8180.
2025-08-09 09:50:36 +02:00
parulin
978efb3514
Two code-block language mistakes 2025-08-08 16:55:35 -04:00
parulin
6f4370f793
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-08 16:55:35 -04:00
parulin
4212c5eda8
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-08 16:55:35 -04:00
parulin
a252dc4338
Use console lexer instead of bash with a prompt 2025-08-08 16:55:34 -04:00
parulin
31c890baa1
Remove duplicate captions and wrong alt formatting of images 2025-08-08 16:52:48 -04:00
Marek Marczykowski-Górecki
810901e5d6
ci: remove gitlab ci
RTD provides own CI service
2025-08-08 22:51:05 +02:00
parulin
f9cbfad0a3
Ignore the _build directory 2025-08-08 16:39:37 -04:00
parulin
31489845be
Add minimal configuration for linkcheck builder
* Avoid checking .onion domains.
* Do not download links to check anchors
2025-08-08 16:39:23 -04:00
parulin
23f3e2f4cc
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-08 16:38:54 -04:00
parulin
21e631272d
Fix Xen link on intro.rst 2025-08-08 16:22:33 -04:00
parulin
62eafae504
Introduction: correct an image position 2025-08-08 16:22:21 -04:00
parulin
c977c44bed
Adding screenshots to How to enter fullscreen mode 2025-08-06 17:27:50 -04:00
parulin
0c5100f409
Update How to enter fullscreen mode 2025-08-06 09:43:26 -04:00
Marek Marczykowski-Górecki
d428c3bf29
Update documentation version number 2025-08-06 02:20:01 +02:00
Marek Marczykowski-Górecki
f058f77394
manual fixes
Manual fixes after the conversion tool. Mostly based on sphinx warnings.
2025-08-06 02:20:01 +02:00
Marek Marczykowski-Górecki
d42b5ce13f
Import attachment repo
Import only files used in the documentation (and their source files if
applicable).
Imported from https://github.com/QubesOS/qubes-attachment at
52bc8a22484236c5bd494707aafe32aa5e849950.
2025-08-06 02:20:01 +02:00
Marek Marczykowski-Górecki
918eaa479d
Convert to RST
This is done using tools at
https://github.com/maiska/qubes-translation-utilz, commit
4c8e2a7f559fd37e29b51769ed1ab1c6cf92e00d.
2025-08-06 02:19:56 +02:00
Marek Marczykowski-Górecki
e14921b8a3
Rename all md files to rst
This is plain rename without changing content, to help git track files
history.
Do not touch files that are going to be removed during conversion.

Thanks @parulin for the idea!
2025-08-06 02:16:04 +02:00
parulin
bc34fd1ab7
HTML theme: style external links and add logos 2025-07-27 03:38:23 -04:00
Marek Marczykowski-Górecki
ba609d123e
Update documentation version number 2025-07-05 20:26:43 +02:00
Marek Marczykowski-Górecki
5432f95705
manual fixes
Manual fixes after the conversion tool. Mostly based on sphinx warnings.
2025-07-04 14:47:18 +02:00
Marek Marczykowski-Górecki
d3f5fafcde
Import attachment repo
Import only files used in the documentation (and their source files if
applicable).
Imported from https://github.com/QubesOS/qubes-attachment at
52bc8a22484236c5bd494707aafe32aa5e849950.
2025-07-04 14:33:37 +02:00
Marek Marczykowski-Górecki
7e464d0f40
Convert to RST
This is done using tools at
https://github.com/maiska/qubes-translation-utilz, commit
4c8e2a7f559fd37e29b51769ed1ab1c6cf92e00d.
2025-07-04 14:23:09 +02:00
qubedmaiska
e3db139fe3
fixed a tab 2025-07-01 16:12:00 -04:00
qubedmaiska
4554eef362
exchanged webarchive links, minor wording 2025-07-01 03:17:45 -04:00
qubedmaiska
823c5f34ba
admin-api reset to upstream 2025-06-05 20:19:22 -04:00
qubedmaiska
7eaecbd560
update from upstream 2025-06-05 18:54:55 -04:00
unman
b9a4429552
Update KDE page with more detailed information post install 2025-06-05 15:18:41 +00:00
Andrew David Wong
117b9ee6a3
Remove Joanna from list of security team members
Thanks to oli from the Qubes OS Forum for pointing this out:
https://forum.qubes-os.org/t/qubes-canary-043/34234/2

Full explanation:
https://forum.qubes-os.org/t/qubes-canary-043/34234/3
2025-06-05 05:45:51 -07:00
qubedmaiska
524928b022
pre-final fixes 2025-06-03 13:51:29 -04:00
qubedmaiska
3c689c9217
merge noskb/patch-3 PR#1303 2025-05-31 07:34:03 -04:00
qubedmaiska
78654bf052
added space, fixed links 2025-05-28 09:46:41 -04:00
unman
473fb5d323
Update Templates page.
Includes some changes based on #1206
2025-05-27 13:04:44 +00:00