Commit graph

7645 commits

Author SHA1 Message Date
qubedmaiska
bb4a0b720f
merge upstream and add rst version of the how to edit Markdown and Markdown and website style guide docs 2025-09-08 02:03:08 -04:00
qubedmaiska
7172de20be
WIP, add screenshots, tips&tricks, rename old documentation 2025-09-08 01:57:27 -04:00
qubedmaiska
4d3109bfc2
Add rst files about how to edit the documentation, documentatioon and website style guide in Markdown 2025-09-08 01:24:47 -04:00
qubedmaiska
6ecfe972a1
merge PR #1494 and fixed conflicts 2025-09-06 07:03:33 -04:00
qubedmaiska
adf0dd0f1c
Merge remote-tracking branch 'parulin/update-how-to-fullscreen' into rst 2025-09-06 06:51:21 -04:00
qubedmaiska
da7479aa81
Merge branch 'pr/1493' into rst 2025-09-06 06:48:38 -04:00
parulin
94e1cf07ff
Adding missing link to qubes-core-qrexec
Once again, a valuable piece of documentation lost in the internet...
2025-09-06 12:26:34 +02:00
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
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
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