Compare commits

..

377 commits

Author SHA1 Message Date
qubedmaiska
59488e73ef
Merge remote-tracking branch 'parulin/intro-remove-headings' 2025-09-21 13:13:30 -04:00
qubedmaiska
04d278b0a4
Merge remote-tracking branch 'parulin/intersphinx' 2025-09-21 13:10:09 -04:00
parulin
5fd9a6b52f
Remove garbage content introduced with intersphinx 2025-09-21 11:48:12 -04:00
parulin
cfffa34a43
Revert some links in intro
Revert some links introduced or removed in a4dd0000
2025-09-21 11:43:52 -04:00
Marek Marczykowski-Górecki
6d0aeb3570
Update 4.3 release schedule 2025-09-19 17:43:54 +02:00
Solène Rapenne
a595faa4e6
Merge branch 'pr/1522' 2025-09-19 14:32:46 +02:00
unman
d67839aca4
Minor edit to firewall.rst
Credit to @Greylinux
Closes #1521
2025-09-19 10:59:01 +00:00
parulin
03dc04d4f6
Merge remote-tracking branch 'upstream/main' into intro-remove-headings 2025-09-17 08:07:05 -04:00
parulin
a4dd000030
Introduction: markup changes
Following the doc migration from Markdown to RestructuredText, a more
logical markup was applied to the *Features* section, but not to the
section about *video tours*, *screenshots* and *Getting started*. I
changed that last section and ended up using a definition list also for
the Features section (seems more consistent and appropriate as links are
allowed in titles.

The `figure` markup should be used for images with a caption or a
description**
2025-09-17 07:59:04 -04:00
parulin
1d3298cf6d
Correct "Windows as a template" ref on Standalones 2025-09-16 03:47:13 -04:00
parulin
56e3b966cf
Merge remote-tracking branch 'upstream/main' into ref-warning-fix-glossary-windows 2025-09-16 03:39:33 -04:00
parulin
c4d890d7c0
Fix wrong roles warnings and wording 2025-09-15 05:03:50 -04:00
parulin
12f2c7a9bd
Fix minor typo on "how-to edit the rst doc..."
Fix the "reStrucutredText" words. That's a good example on why it is
better not to label link when possible :)

There is other minor typos and inconsitencies (RST instead of rST).
2025-09-15 04:14:19 -04:00
Solène Rapenne
b0be3be4ee
Merge branch 'pr/1531' 2025-09-14 12:00:28 +02:00
Solène Rapenne
656ac06430
Merge branch 'pr/1529' 2025-09-14 11:58:19 +02:00
Solène Rapenne
0fcd7d2707
Merge branch 'pr/1517' 2025-09-14 11:52:40 +02:00
Solène Rapenne
26d226b632
Merge branch 'pr/1516' 2025-09-14 11:49:49 +02:00
Solène Rapenne
6110d5f16c
Merge branch 'pr/1497' 2025-09-14 11:43:48 +02:00
parulin
f0709dd483
Fix minor typos and link on rst related pages 2025-09-13 17:35:21 -04:00
parulin
47252ef12e
Merge remote-tracking branch 'origin/main' into intersphinx 2025-09-13 17:26:08 -04:00
parulin
1a47fc973b
Add intersphinx documentation and clean syntax
* I replaced the `:external:` syntax by a cleaner one, as suggested by
  @maiska.
* An implicit external reference is now impossible.
* Fix duplicate labels warnings
* Minor typos, including the word "orthographicallly" :)
2025-09-13 17:18:52 -04:00
qubedmaiska
d9a6e20f3a
add labeling of sections inside rst docs 2025-09-13 11:16:12 -04:00
qubedmaiska
0f77371239
add screenshots with main branch, remove obsolete images, references to main branch instead of rst for conf.py, .readthedocs.yml, attachment, _ext, use .venv 2025-09-13 09:42:04 -04:00
parulin
b052a98721
Add core-qrexec to the intersphinx mappings 2025-09-13 08:53:36 -04:00
parulin
c40c0ac302
Install intersphinx extension and edit links
Some anchor links are currently lost on:

* developer/system/template-manager.rst
* user/how-to-guides/how-to-enter-fullscreen-mode.rst
2025-09-13 04:37:05 -04:00
Marek Marczykowski-Górecki
b2f7011b82
Add info how to (re)enable KDE Wayland
QubesOS/qubes-issues#8515
2025-09-13 02:45:05 +02:00
parulin
c81847a780
Fix typos on how-to-enable-a-service 2025-09-12 17:29:46 -04:00
parulin
90de0563de
Correct typos in how-to-edit-a-policy 2025-09-12 17:22:56 -04:00
parulin
804acc1f65
Clarify how-to-edit-a-policy following review
Following @rapenne-s review:

* make clear that the first method is for the most common policies
* explain how priority works
* provide the user a way to modify the default editor
* some typos

Reading again the help text of `qubes-policy-editor` I made some
corrections.
2025-09-12 17:09:41 -04:00
Dr. Gerhard Weck
97e907f9c7 Copy files from rstWk to master 2025-09-12 17:16:31 +02:00
Dr. Gerhard Weck
74a7f49262
Change links to new documentattion 2025-09-12 10:53:23 +02:00
Dr. Gerhard Weck
d9a30dc6a5 Copy files from rstWk to master 2025-09-12 10:39:30 +02:00
Dr. Gerhard Weck
01e52b382f
Remove old file 2025-09-12 10:16:38 +02:00
Dr. Gerhard Weck
a81bb6e412
Remove old file 2025-09-12 10:16:05 +02:00
Dr. Gerhard Weck
8da2202d18
Remove old file 2025-09-12 10:14:59 +02:00
Dr. Gerhard Weck
6961917171
Remove old file 2025-09-12 10:14:29 +02:00
Dr. Gerhard Weck
a41df4271f
Remove old file 2025-09-12 10:14:01 +02:00
saces
c9ee35aa07
add esbonio preview configuration 2025-09-12 09:26:43 +02:00
saces
c1c1b3bee3
add .venv to ignore 2025-09-12 09:26:38 +02:00
saces
ccfe6183a6
fix exclude pattern in conf.py 2025-09-12 09:26:32 +02:00
qubedmaiska
0bf898475f
fix references, refactor website style doc and others 2025-09-09 23:30:17 -04:00
qubedmaiska
bd26dee6a4
add info about readthedocs.yml, exchange code-block with code to be consistent 2025-09-09 12:15:52 -04:00
qubedmaiska
1be6e5f9b9
fixed linter warnings 2025-09-09 12:05:31 -04:00
qubedmaiska
e93ddb3796
fixed reference errors, minor enhancements to the docs, fix pyproject.toml, alt text to images 2025-09-09 11:39:34 -04:00
qubedmaiska
4404a5d5f5
merge upstream rst, add screenshots, rewrite how-to-edit-the-website, combine website and markdown-style-guide, enhance how-to-edit-the-rst-documentation and rst style guide, fix errors, added comments to conf.py, links to README & CONTRIBUTING 2025-09-09 05:29:19 -04:00
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
Ali Mirjamali
bb5054c462
Initialize asyncio event loop before using it
Python 3.14 (in Fedora 43) throws RunetimeError if event loop is not
initialized before using it.

Resolves: QubesOS/qubes-issues#10188
2025-08-27 21:34:24 +03:30
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
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
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
unman
5b5a4ebd9b
Update Debian and Fedora template pages. 2025-05-27 12:09:11 +00:00
unman
909f7ae7a8
Update admin API page with details of new notes API
Merge branch 'pr-1450'
2025-05-27 00:09:57 +00:00
unman
a00b4a18c0
Update How to Install Software page with dnf5 syntax for enabling
repositories
Merge branch 'pr-1442'
2025-05-26 23:29:45 +00:00
qubedmaiska
f487cd4261
update from upstream 2025-05-25 06:03:22 -04:00
unman
684a7cee24
Minor edits to Secondary Storage page 2025-05-25 01:17:06 +00:00
unman
9c51e9594d
Add Btrfs details to secondary storage page, and edit for clarity 2025-05-25 01:10:35 +00:00
unman
f72ad83ffb
Edit secondary storage page for clarity 2025-05-25 01:05:24 +00:00
unman
fd0ae463fe
Merge branch 'pr-1474' 2025-05-25 00:38:52 +00:00
unman
487f7e21cd
Update sys-gui-gpu to make it clear that this is not for improving Performance
Merge branch 'pr-1477'
2025-05-25 00:32:23 +00:00
Solène Rapenne
34144a1620
doc: make clear that sys-gui-gpu is not meant for improving performance 2025-05-24 15:05:14 +02:00
qubedmaiska
23dce7002e
Merge remote-tracking branch 'upstream/main' 2025-05-21 18:45:23 -04:00
lafried
d76402c3dd
Fix syntax for dnf5 support 2025-05-21 02:11:50 +01:00
qubedmaiska
9e6c2e4924
update from upstream 2025-05-20 03:42:19 -04:00
qubedmaiska
3e3d5d32d3
Merge remote-tracking branch 'origin/novacustom-v5x-heads' 2025-05-20 03:14:06 -04:00
qubedmaiska
e520e2e559
fix for warning display and a url 2025-05-19 03:46:03 -04:00
qubedmaiska
9f76056671
minor format fixes 2025-05-19 03:10:16 -04:00
Ali Mirjamali
2b028834a6
Fixing existing CI/CD issues 2025-05-18 22:02:46 +03:30
Ali Mirjamali
0ead1b03a1
Add the new notes API documentation
related: https://github.com/QubesOS/qubes-issues/issues/899
2025-05-18 20:46:33 +03:30
Andrew David Wong
caffc06eaf
Add Heads certified firmware option for NovaCustom V54 & V56 2025-05-15 17:06:24 -07:00
m
fa3b299a51
Merge branch 'QubesOS:main' into main 2025-05-15 15:12:04 -04:00
unman
b594557061
Minor change to headings on update page. 2025-05-15 12:12:18 +00:00
unman
46e4e0a684
Add information on how to update firmware. Merge pr-1437 2025-05-15 12:09:23 +00:00
unman
093b2f919a
Fixed type in mfa page
Merge branch 'pr-1441'
2025-05-15 11:33:42 +00:00
unman
fe22ae7e9f
Fixed typo in mfa page 2025-05-15 11:33:22 +00:00
unman
61a4deb1ac
Add known issues to information on use of gui domain
Merge branch 'pr-1440'
2025-05-15 11:16:27 +00:00
unman
b87aaed495
Clarify use of Updates Proxy when updating and installing software
Merge branch 'pr-1459'
2025-05-15 11:08:33 +00:00
unman
73294eb89d
Minor changes in how-to-install-software 2025-05-15 11:08:21 +00:00
unman
aa62d0b296
Minor changes in how-to-install-software 2025-05-15 11:07:17 +00:00
unman
edc3d8bfec
Add worked example of setting network in HVM
Merge branch 'pr-1462'
2025-05-15 10:35:00 +00:00
unman
c6b07c0191
Added Titles to images.
Normalised language in description of procedure
2025-05-15 10:29:39 +00:00
qubedmaiska
284e6d41f4
format fixes 2025-05-14 19:10:54 -04:00
qubedmaiska
0688e5d7b3
update doc locally 2025-05-14 09:00:17 -04:00
unman
0329e3d4cc
Fix outdated link on qrexec-internals page.
Merge branch 'pr-1472'
2025-05-14 12:21:14 +00:00
Woolfgm
07b2392c3f
Update qrexec-internals.md 2025-05-14 11:40:56 +02:00
Andrew David Wong
9fede33dcd
Remove Fedora 40 from supported templates (EOL) 2025-05-13 13:39:41 -07:00
unman
11cc56d59d
Certified Hardware - Privacy Beast - update link
Merge branch 'pr-1471'
2025-05-11 13:10:04 +00:00
unman
a5b15bdf5b
Add link to incomplete page on split-gpg-2 from current split-gpg page 2025-05-11 12:30:50 +00:00
unman
ec6f975c82
Add separate page for split-gpg-2 2025-05-11 12:07:51 +00:00
unman
fa23b34a24
Revert "Update documentation on split-gpg2"
This reverts commit 0062dfaa37, reversing
changes made to 7167897d71.

Retain documentation on split-gpg and add page on split-gpg-v2 as well,
until latter page is fully functional.
2025-05-11 11:46:13 +00:00
Woolfgm
b7dd717ee7
Update insurgo-privacybeast-x230.md 2025-05-11 13:01:27 +02:00
unman
690d289886
Update Debian page to make it clear that the Debian template from 4.2.4 cannot be used for salting other qubes. 2025-05-04 12:16:00 +00:00
qubedmaiska
f55702643d
update upstream 2025-05-03 10:18:23 -04:00
unman
ae512816bb
Release notes - Correct link to API documentation
Merge branch 'pr-1467'
2025-05-02 15:02:33 +00:00
unman
0c4d924d21
Update release notes link to head API 2025-05-02 15:00:25 +00:00
unman
41470dbee4
Update secondary storage page: work around 4k incompatibility, drop unnecessary luksFormat arguments
Merge branch 'pr-1443'
2025-05-02 01:08:19 +00:00
unman
e4e60859c5
Update VPN troubleshooting guide
Merge branch 'pr-1283'
2025-05-02 00:28:40 +00:00
unman
55441615bf
Fix reference to /var/logs/syslog, and add journalctl.
Update link from Qubes-Community to Forum guides. Minor changes.
2025-05-02 00:24:26 +00:00
unman
ef37a8c68b
Update page on standalones with informatin about virtualization modes.
Closes https://github.com/QubesOS/qubes-issues/issues/7517
2025-04-30 13:15:08 +00:00
unman
4a91a742fe
Minor changes to How to use USB devices page. 2025-04-30 12:05:15 +00:00
unman
e1ced53d9f
Clarify instructions for finding USB controller/address
Fix style
Merge branch 'pr-1265'
2025-04-30 11:49:59 +00:00
unman
7870666de3
Clarified that main method relates to finding controller for attached device.
Moved QubeManager method to separate section
2025-04-30 11:42:31 +00:00
unman
e99e33317a
Update Getting Started page
Merge branch 'pr-1368'
2025-04-29 12:40:45 +00:00
unman
bd8a419412
Slight change to comment on use of color.
Fix minor spelling mistake.
2025-04-29 12:35:08 +00:00
PixelPilot
5bd45751f9
Update release-notes.md 2025-04-27 09:06:44 +02:00
unman
db82711863
Describe further changes required for Win11 installation.
Merge pr-1466
2025-04-26 10:54:25 +00:00
unman
1624edfba9
Merge branch 'pr-1438' 2025-04-26 10:47:29 +00:00
unman
cde877dd73
Describe how to move user profiles without QWT installation
Merge branch 'pr-1421'
2025-04-26 10:43:08 +00:00
Dr. Gerhard Weck
5cb2a1e404
Describe installation changes for Windows 11 2025-04-25 13:56:11 +02:00
qubedmaiska
bb37d69f56
update upstream 2025-04-22 03:09:13 -04:00
unman
2f4de87cd4
Provide evidence that AMD is slow to ship client microcode
Merge branch 'pr-1430'
Cf Discussion at https://forum.qubes-os.org/t/the-nitropc-pro-2-is-qubes-certified/24762/16
2025-04-21 11:09:17 +00:00
unman
f754dc7aa7
Improve system update documentation with information on updating
firmware
Merge branch 'pr-1414'
2025-04-21 10:34:56 +00:00
unman
0062dfaa37
Update documentation on split-gpg2
Merge branch 'pr-1411'
2025-04-21 10:22:00 +00:00
unman
7167897d71
Add information on new device API
Merge branch 'pr-1387'
2025-04-21 10:06:35 +00:00
unman
c6b0237db6
Update networking page to make it clear that the ipv6 feature only affects qubes-configured networking 2025-04-19 14:03:45 +00:00
qubedmaiska
cf30f8bab8
update 2025-04-16 10:37:02 -04:00
unman
f8e2bb2258
Update docs with information on /rw/config/rc.local* scripts
Merge branch 'pr-1433'
2025-04-13 14:46:53 +00:00
unman
b9bec14ae4
Update firewall page to make sure sys-net rules are correctly specified 2025-04-13 14:37:15 +00:00
unman
df5f5b9ede
Update firewall page to use iifgroups rather than iif
Merge branch 'pr-1412'
2025-04-13 14:00:19 +00:00
unman
63ad8ab1c1
Minor changes to description of qubes-builder-v2 2025-04-13 12:57:18 +00:00
unman
81e4abc416
Minor changes to workflow.md using Builder v2 2025-04-13 12:55:19 +00:00
unman
7b8f4e0740
Add introduction for Builder v2
Merge branch 'pr-1409'
2025-04-13 12:47:00 +00:00
unman
362b0618b6
Update templates page to reflect use of qvm-template.
Merge pr-1322
2025-04-13 11:08:44 +00:00
unman
68be810d95
Add tweaks to Emergency backup restore instructions
Merge branch 'pr-1302'
2025-04-11 14:28:23 +00:00
unman
abdafabff2
Update and improve Emergency backup restore
Merge branch 'pr-1279'
2025-04-11 14:23:31 +00:00
unman
674f9b6dd2
Fix dead link to Micah's video 2025-04-10 13:37:18 +00:00
Andrew David Wong
187db01576
Fix dead link 2025-04-09 15:43:48 -07:00
Andrew David Wong
c4129f8852
Fix dead links 2025-04-09 15:02:04 -07:00
garindean
e529345e72
Update how-to-organize-your-qubes.md
grammar
2025-04-02 01:10:15 -04:00
qubedmaiska
951baf6ea6
minor rewording, formatting 2025-03-31 02:59:41 -04:00
qubedmaiska
8300200c1d
Merge branch 'refs-patch' 2025-03-26 17:31:37 -04:00
qubedmaiska
67e3ffccc7
add ref to metadata to be consistent across documentation though soon obsolete 2025-03-26 17:25:49 -04:00
qubedmaiska
66c0baff53
minor formatting & url fix 2025-03-26 17:20:33 -04:00
m
cbf4baa9c6
Merge branch 'QubesOS:main' into main 2025-03-25 19:28:49 -04:00
m
af631c8d23
Merge branch 'QubesOS:main' into main 2025-03-24 19:59:10 -04:00
Francis King
e86436d023
Added some extra text and an example
In a discussion on Qubes OS forum, it was decided that I should add some extra text about the netmask, and an example  for Network Manager. The purpose being to make the procedure much clearer.

There are two images to go into the text, but I don't understand how to do that yet. I have used '>' at those points. Please advise.

Francis.
2025-03-24 16:08:35 +00:00
3np
f71614efd9
how-to-install-software: clarify updates-proxy usage
- makes it less likely to get the false impression that
  the updates proxy does not allow arbitrary outbound connections
- add example of how to download software in templates without
  enabling direct networking
2025-03-23 02:16:21 +00:00
Marta Marczykowska-Górecka
06e37e444b
Add intro for Builder v2 2025-03-22 22:18:04 +01:00
qubedmaiska
2af734f848
Merge branch 'main' of https://github.com/maiska/qubes-doc.rtd 2025-03-21 18:38:51 -04:00
qubedmaiska
0c274977fe
minor formatting, wording 2025-03-21 18:38:35 -04:00
m
1620034059
Merge branch 'QubesOS:main' into main 2025-03-20 20:54:50 -04:00
m
7e2b1b1858
Merge branch 'QubesOS:main' into main 2025-03-15 20:39:49 -04:00
qubedmaiska
3a603a3665
Merge branch 'main' of https://github.com/maiska/qubes-doc.rtd 2025-03-09 15:57:47 -04:00
qubedmaiska
6f9a1d7343
formatting, valid url 2025-03-09 15:57:38 -04:00
m
99829ef29d
Merge branch 'QubesOS:main' into main 2025-03-08 07:12:05 -05:00
qubedmaiska
d4461fb4cb
formatting, webarchive links, add icons 2025-02-27 16:10:31 -05:00
qubedmaiska
2093a276b8
merge form upstream 2025-02-21 04:48:20 -05:00
qubedmaiska
2f094ef07d
url fixes, md link fix for rst translation 2025-02-21 04:40:39 -05:00
Demi Marie Obenour
cc13bd9ee8
Provide evidence that AMD is slow to ship client microcode
The claims in the documentation are corrrect, but no sources were
provided.  Add links to sources.

Fixes: QubesOS/qubes-issues#9485
2025-02-20 21:18:17 -05:00
qubedmaiska
f62ae0b14b
added mailing list clarification 2025-02-15 20:55:00 -05:00
qubedmaiska
d6925e063d
QA rst conversion releases section: replace master with main in 1 file, archive link from a currently dead one, typo fix 2025-02-14 17:51:17 -05:00
qubedmaiska
8fb701ea79
add new line for correct conversion from md to rst 2025-02-09 17:23:15 -05:00
qubedmaiska
f3d5fb45d8
add new line for correct conversion of code block from md to rst 2025-02-09 14:05:59 -05:00
m
8338dab1fd
Merge branch 'QubesOS:main' into main 2025-01-30 16:15:24 -05:00
ghijg
c339a093fc
Merge branch 'QubesOS:main' into patch-2 2025-01-24 22:13:51 +01:00
m
b88a6bfda0
Merge branch 'QubesOS:main' into main 2025-01-24 08:00:15 -05:00
qubedmaiska
bef2385ba1
icon properly displayed, formatting 2025-01-23 17:04:26 -05:00
qubedmaiska
b9067f7b80
hyperlink fix in markdown 2025-01-22 18:15:27 -05:00
qubedmaiska
2d3bfcb39f
small formatting fixes in markdown 2025-01-22 13:29:16 -05:00
qubedmaiska
e7385e96b5
merged upstream 2025-01-18 15:40:24 -05:00
qubedmaiska
8085719b1c
small formatting issues 2025-01-18 15:21:06 -05:00
qubedmaiska
cb1f45fe97
removed new lines 2025-01-16 17:02:58 -05:00
qubedmaiska
acfadd1193
formatting 2025-01-16 16:24:24 -05:00
qubedmaiska
79b2bfbb6b
removed extra * char 2025-01-16 15:35:55 -05:00
qubedmaiska
4b625ee666
Rearranged hyperlinked words 2025-01-15 15:29:39 -05:00
qubedmaiska
62d9a4f084
Fixed hierarchy of titles and added a fullstop 2025-01-14 20:51:46 -05:00
m
ed16d1265d
Merge pull request #2 from maiska/toki-newlines
Toki newlines
2024-12-27 13:43:58 -05:00
qubedmaiska
00b72eb890
Merge branch 'main' into toki-newlines 2024-12-27 13:40:23 -05:00
m
c440190791
Merge branch 'QubesOS:main' into toki-newlines 2024-12-25 13:32:43 -05:00
m
6b75c50248
Merge branch 'QubesOS:main' into main 2024-12-25 13:32:09 -05:00
Rusty Bird
65e0511d15
luksFormat: drop --hash=sha512 argument
The default (sha256) seems fine for LUKS2 where the hash algorithm has a
limited role anyway - it's not used for key stretching like in LUKS1.
2024-12-20 19:29:38 +00:00
Rusty Bird
4fb0f0c851
luksFormat: drop arguments that are already the default 2024-12-20 19:29:37 +00:00
Rusty Bird
cc00196539
luksFormat: add --sector-size=512 argument 2024-12-20 19:29:36 +00:00
ghijg
1fca26ce44
Syntax changed due to dnf5/Fedora41
Syntax changed for enabling repositories with dnf5 which is used by default from Fedora 41 on.

https://dnf5.readthedocs.io/en/latest/changes_from_dnf4.7.html
2024-12-10 00:13:35 +01:00
Darekisgit
4cc913b6b0
Update mfa.md 2024-12-04 12:21:25 +01:00
Christian Tramnitz
ae26177e4d
add known issues to gui-domain docs
Although sys-gui (and its variants sys-gui-gpu and sys-gui-vnc) are clearly marked to be used by advanced users only, there are some limitations that may go beyond the expectations of an advanced user.

This updates the documentation to contain some known issues that probably don't have a quick fix.
2024-12-01 12:39:23 +01:00
b90g
7c7911177f
Update windows-qubes-4-1.md
evading microsoft account enforcement.
2024-11-29 20:21:29 +01:00
Rowen S
d1cb9bd2fb
Add documentation on qubes-fwupdmgr usage 2024-11-25 14:14:48 -05:00
Marek Marczykowski-Górecki
8ae7c24958
Update docs about /rw/config/rc.local* scripts
Specify that files needs to be executable.
Add info about `/rw/config/rc.local.d/*.rc`.
Add info about `/rw/config/rc.local-early.d/*.rc` and
`/rw/config/rc.local-early`
(https://github.com/QubesOS/qubes-core-agent-linux/pull/386)
2024-10-20 00:41:01 +02:00
m
412744882b
Merge branch 'QubesOS:main' into main 2024-10-17 19:41:00 -04:00
qm
89f81ecf82
added sublists for better rst conversion formatting 2024-10-04 10:27:11 -04:00
m
da85dd62d4
from bold to italic in title for better rst conversion 2024-09-27 13:48:11 -04:00
m
0d9309ed58
rst conversion omitting extra space 2024-09-27 13:22:43 -04:00
m
d4edd480fe
Merge branch 'QubesOS:main' into main 2024-09-22 08:34:01 -04:00
m
c2a8a91356
Merge pull request #1 from maiska/toki-newlines
Reformat for better conversion to RST
2024-09-22 07:59:11 -04:00
qm
9b2e206e53
merge main 2024-09-22 07:57:42 -04:00
qm
8003064f51
fixed identation in lists, created sublists of lists, minor formatting fixes 2024-09-22 07:38:20 -04:00
Tobias Killer
b330828152 Reformat for better conversion to RST
- essentially concerning the newline issue in lists
2024-09-21 19:34:01 +02:00
Dr. Gerhard Weck
63bf921aa6
Formal change 2024-09-21 13:27:20 +02:00
qm
1ffc54d84b
fixed list for better rst conversion 2024-09-20 13:15:36 -04:00
qm
bfbad2b186
removed a TODO comment for better rst conversion 2024-09-20 13:00:42 -04:00
qm
3006e841f8
preparation for rst conversion 2024-09-12 14:58:55 -04:00
qm
6c32c9dc4e
preparation for rst conversion 2024-09-12 09:50:01 -04:00
qm
bdc020a10e
new line 2024-09-03 17:23:25 -04:00
Dr. Gerhard Weck
9218f23167
Describe Move user profiles without QWT installation 2024-08-25 10:12:11 +02:00
Demi Marie Obenour
0250897727 Document how to update system firmware
This is a very important task, but it is often not done due to bad
tools.  Also correct some outdated information on the "how to update
software" page.
2024-08-22 16:35:22 -04:00
qm
df88acabc3 preparation rst conversion 2024-08-11 20:15:08 -04:00
qm
d7d03089f8 preparation rst conversion 2024-08-11 19:39:45 -04:00
qm
bdda0ae8dc preparation rst conversion 2024-08-11 19:18:55 -04:00
m
5c4c4833cc
preparation rst conversion 2024-08-11 09:36:35 -04:00
m
d8eea9fb67
rst preparation conversion 2024-08-11 09:35:03 -04:00
m
abbe9b1947
preparation rst conversion 2024-08-11 09:33:47 -04:00
m
b98221abc5
preparations rst conversion 2024-08-11 09:31:34 -04:00
m
5926d887b3
preparation rst conversion 2024-08-11 09:29:41 -04:00
m
3e93bd58b8
preparation conversion rst 2024-08-10 10:48:13 -04:00
m
f9c371542a
preparation rst conversion 2024-08-10 10:47:07 -04:00
m
230c80f502
Merge branch 'QubesOS:main' into main 2024-08-09 00:27:28 -04:00
m
5941ae92ec
Merge branch 'QubesOS:main' into main 2024-07-28 18:10:10 -04:00
m
a60dc3ad87
prepare conversion to rst 2024-07-28 18:06:54 -04:00
m
ae1446925f
preparation rst ocnversion 2024-07-28 12:08:31 -04:00
m
7c2b1a498a
preparation rst ocnversion 2024-07-28 12:07:45 -04:00
m
da97d63f53
preparation rst ocnversion 2024-07-28 12:07:12 -04:00
m
8fd6045d79
preparation rst ocnversion 2024-07-28 12:06:39 -04:00
m
b7c6ff3cc9
preparation rst conversion 2024-07-28 12:04:31 -04:00
m
38cfff0ca2
preparation rst conversion 2024-07-28 12:03:07 -04:00
m
0a94a1f35e
preparation rst conversion 2024-07-28 12:00:29 -04:00
m
32c32e6659
preparation rst conversion 2024-07-28 11:59:50 -04:00
apparatius
ec1f501c53
Update firewall.md
The disappearance of the eth0 interface when you restart the net qube of the sys-firewall or set it’s net qube to none is causing `iif == "eth0"` to become `iif 2` and the rules won't work anymore.
It’s better to use `iifgroup 1` instead of `iif == "eth0"`.
Related discussion:
https://forum.qubes-os.org/t/iptables-not-available-in-sys-net-in-qubes-os-4-2-1/26706/26
2024-07-12 09:31:11 +00:00
ooops
2d5c636c05
Includes updated documentation from split-gpg2
Fixes QubesOS/qubes-issues/issues/9138
2024-07-08 15:33:48 -04:00
ooops
13b46e5c0c
Update split-gpg.md 2024-07-08 15:11:44 -04:00
m
93f851d813
for better conv to rst 2024-07-06 19:25:12 +02:00
m
90ed11a52a
better conv for rst 2024-07-06 18:49:41 +02:00
m
a1e5c64c49
better conv for rst 2024-07-06 02:37:44 +02:00
m
326adab3c0
better formatting for rst conv 2024-07-02 23:09:39 +02:00
m
2346dac166
formatting for better rst conversion 2024-07-02 22:47:44 +02:00
m
c78d5624d8
better formatting for rst conversion 2024-07-02 22:46:29 +02:00
Piotr Bartman
3cec58bf7d
q-dev: update docs 2024-06-30 11:26:54 +02:00
m
607d525d43
better conv 4 rst 2024-06-12 18:44:05 +02:00
m
ee6a768d32
better conv for rst 2024-06-12 18:18:45 +02:00
m
5050b8d1aa
better comv for rst prep 2024-06-08 20:03:50 +02:00
m
6b2ad28033
newline rst conv 2024-06-01 17:37:40 +02:00
m
3dcfa93aa7
new line rst conv 2024-06-01 17:37:25 +02:00
m
3ef2cd78ae
new lines rst conv 2024-06-01 17:36:57 +02:00
m
6cf2fd5ea1
add new line for better rst conv 2024-06-01 16:38:24 +02:00
m
20972f2798
add newline for better rst conversion 2024-06-01 16:03:52 +02:00
m
0f1268e25e
Remove space for better rst conversion 2024-06-01 14:33:23 +02:00
m
d04ee197c9
add newlines for better rst conversion 2024-06-01 14:32:45 +02:00
m
be4bbda177
add newline for better rst conversion 2024-06-01 13:08:36 +02:00
chomiczosc
4a9ab9fac5
Update getting-started.md
Fixes from review
2024-01-05 15:45:08 +01:00
chomiczosc
108fb1e106
Update getting-started.md
- simplifying "Getting started section" to make it more comprehensible
- updating the section to match Qubes 4.2
2024-01-05 15:26:36 +01:00
Rusty Bird
0aee55a8dd
Use ls instead of cat to show example data
https://forum.qubes-os.org/t/getting-stuck-on-emergency-backup-recovery/18520/5
2023-06-20 13:52:31 +00:00
Rusty Bird
6e15603483
Clarify reading the passphrase
https://forum.qubes-os.org/t/getting-stuck-on-emergency-backup-recovery/18520/5
https://forum.qubes-os.org/t/getting-stuck-on-emergency-backup-recovery/18520/6
2023-06-20 13:52:30 +00:00
Oni
1e7a9f7437
Address two potential issues raised when removing a template
Mentioned the final confirmation step asked for by the `Qube Manager`
to type the template's name. However, before this final confirmation
is displayed, issues may be raised. Deleting templates may run afoul
of dependent qubes and the "default_template" global
property. Instructions to resolve via switching are linked.
2023-06-19 08:42:59 -04:00
Oni
781780f07e
Redirect Qubes Menu issues with template uninstallation
Manually removing Qubes Menu entries is covered on the linked page.
2023-06-19 07:45:25 -04:00
Oni
e1abb55e63
Retire template removal warning messages
This section was added in response to:

https://github.com/QubesOS/qubes-issues/issues/6432

Seven months later, 'qvm-template' became the installation redirection
target:

https://github.com/QubesOS/qubes-core-admin-linux/pull/80

Now that 'dnf remove' is not being called directly, these warnings
should not be an issue.
2023-06-19 07:45:18 -04:00
Oni
f24299be1e
Use 'qvm-template' to uninstall templates
The 'dnf remove' command no longer removes templates and mentions "No
Match" when using <package-name-spec>. The 'qvm-template' command will
remove templates from both package installation and
cloning. 'qvm-template' also warns about qubes dependent on the template
which reduces the need for the user to preemptively check that
relationship.

In its implementation, 'qvm-template' imports and calls 'qvm-remove'
to remove the template. 'qvm-template' was selected as the command to
present as it provides a more consistent interface when installing,
listing, and removing among other commands.
2023-06-19 07:45:14 -04:00
noskb
4992cf406e
Modernize uefi-troubleshooting.md
Remove workarounds that no longer function and modernize those that remain
2023-04-25 02:39:38 +00:00
Rusty Bird
d4778384da
Add sys-whonix to example qube list 2023-04-15 16:05:47 +00:00
Rusty Bird
0251ed63d5
Update to a plausible timestamp in the backup ID too 2023-04-15 11:08:35 +00:00
Rusty Bird
51d387a9fe
Add xmlstarlet command
Also update the backup filename's date to avoid anachronisms in the
resulting example qube list (e.g. a backup of fedora-37 in 2015)
2023-04-15 10:45:27 +00:00
Rusty Bird
35b16e2e37
Mention installing the compression program 2023-04-14 16:29:00 +00:00
Rusty Bird
034976f80f
Use vm123/ with a trailing slash like in the backup-path value 2023-04-14 16:28:59 +00:00
Rusty Bird
3b550699af
Emergency backup restore v4 tweaks 2023-04-13 06:47:22 +00:00
Andrew David Wong
f43e54f3a5
Remove unnecessary example and step
Per @rustybird's suggestions on #1279
2023-04-11 16:42:34 -07:00
Andrew David Wong
edbfa3c9b6
Update user/how-to-guides/backup-emergency-restore-v4.md
Co-authored-by: Rusty Bird <rustybird@net-c.com>
2023-04-11 16:35:19 -07:00
zenkuro
a65a507db5
Update vpn-troubleshooting.md
Fix typo
2023-01-07 02:47:34 -05:00
zenkuro
c5314bed7f
Eetend VPN troubleshooting by notify-send case
There are guides and scripts on internet that are helping to configure and run VPN service on QubesOS
This record provides explanation how to identify and what to do to fix possible issues with notify-send that being used by this guides.
2023-01-05 22:57:18 -05:00
Andrew David Wong
39342e8c98
Clarify example 2022-11-23 17:55:04 -08:00
Andrew David Wong
b6c99d486b
Fix typo 2022-11-23 17:53:29 -08:00
Andrew David Wong
9eb7926ffe
Update and improve Emergency backup restore v4 page
- Update formatting and style to be consistent with the rest of the docs
- Improve language
- Clarify instructions
- Improve organization
2022-11-23 17:34:08 -08:00
qubesbugreport
2b24640962
Add instructions for using Qube Manager
Using the Qube Manager to determine USB controller and address
2022-09-01 08:00:33 +02:00
qubesbugreport
dc0819594b
Use sentence case instead of title case
As required by the style guide
2022-09-01 07:32:52 +02:00
zetigu
75d18931d1
Normalize punctuation and create/remove tmp dir
Mostly fix before console text by using ":" without space.
Create/remove /mnt/new_qube_storage
2021-04-02 09:00:36 -04:00
zetigu
32e728d8a9
Add btrfs filesystem show line
Added one btrfs filesystem show line for displaying available btrfs filesystems.
2021-04-02 08:51:33 -04:00
zetigu
6479d371b9
Add shell_session to terminal box
Added a shell_session to the ``` of the first line.
2021-04-02 08:50:03 -04:00
zetigu
8de70db078
Clarification in introduction
More descriptive advantages of using Btrfs
2021-04-02 08:46:44 -04:00
zetigu
a78075a442
Add instruction for using Btrfs as a qvm-pool
I reformated the article to devide it in 2 section, one concerning LVM pools and the other Btrfs pool.
The synthax should be close to the original.
Awaiting comments.
2021-04-01 18:18:49 -04:00
629 changed files with 35131 additions and 29147 deletions

5
.gitignore vendored Normal file
View file

@ -0,0 +1,5 @@
_build
**/__pycache__/*
uv.lock
poetry.lock
.venv

View file

@ -1,6 +0,0 @@
include:
- project: 'QubesOS/qubes-continuous-integration'
file: '/gitlab-website.yml'
build:doc:
extends: .website

25
.readthedocs.yaml Normal file
View file

@ -0,0 +1,25 @@
version: 2
build:
os: "ubuntu-lts-latest"
tools:
python: "3.13"
submodules:
include: all
recursive: true
sphinx:
builder: html
configuration: conf.py
fail_on_warning: false
python:
install:
- requirements: requirements.txt
formats:
- pdf
- epub

View file

@ -2,11 +2,11 @@
Thank you for your interest in contributing to `qubes-doc`, the Qubes OS Thank you for your interest in contributing to `qubes-doc`, the Qubes OS
Project's dedicated documentation repository! Please see [how to edit the Project's dedicated documentation repository! Please see [how to edit the
documentation](https://www.qubes-os.org/doc/how-to-edit-the-documentation/) for documentation](https://doc.qubes-os.org/developer/general/how-to-edit-the-rst-documentation.html) for
detailed contribution instructions. detailed contribution instructions.
In addition, please take a moment to read our [documentation style In addition, please take a moment to read our [documentation style
guide](https://www.qubes-os.org/doc/documentation-style-guide/) before guide](https://doc.qubes-os.org/developer/general/rst-documentation-style-guide.html) before
contributing. These guidelines are important to maintaining high standards of contributing. These guidelines are important to maintaining high standards of
quality, and following them will increase the likelihood that your contribution quality, and following them will increase the likelihood that your contribution
will be accepted. will be accepted.

View file

@ -1,11 +1,11 @@
# Qubes OS Documentation # Qubes OS Documentation
Canonical URL: https://www.qubes-os.org/doc/ Canonical URL: https://doc.qubes-os.org
All [Qubes OS Project](https://github.com/QubesOS) documentation pages are All [Qubes OS Project](https://github.com/QubesOS) documentation pages are
stored as plain text files in this dedicated repository. By cloning and stored as plain reStructuredText files in this dedicated repository. By cloning and
regularly pulling from this repo, users can maintain their own up-to-date regularly pulling from this repo, users can maintain their own up-to-date
offline copy of all Qubes documentation rather than relying solely on the Web. offline copy of all Qubes documentation rather than relying solely on the Web.
To contribute, please see [how to edit the To contribute, please see [how to edit the
documentation](https://www.qubes-os.org/doc/how-to-edit-the-documentation/). documentation](https://doc.qubes-os.org/developer/general/how-to-edit-the-rst-documentation.html).

View file

@ -1,9 +1,29 @@
==============================================
Welcome to Qubes OS developer's documentation! Welcome to Qubes OS developer's documentation!
============================================== ==============================================
This is documentation for the source code. Please choose specific repostitory: This is documentation for the source code. Please choose specific repostitory:
* `core-admin </projects/core-admin>`_ .. toctree::
* `core-admin-client </projects/core-admin-client>`_ :maxdepth: 1
Or see `the main Qubes OS documentation <https://www.qubes-os.org/doc/>`_. core-admin <>
.. _core-admin: /projects/core-admin
core-admin-client <>
.. _core-admin-client: /projects/core-admin-client
qubes-core-qrexec <>
.. _qubes-core-qrexec: /projects/qubes-core-qrexec
Or see the main Qubes OS documentation <https://www.qubes-os.org/doc/>
.. _the main qubes os documentation: https://www.qubes-os.org/doc/
.

68
_ext/youtube_frame.py Normal file
View file

@ -0,0 +1,68 @@
"""
ReST directive for embedding Youtube and Vimeo videos.
There are two directives added: ``youtube`` and ``vimeo``. The only
argument is the video id of the video to include.
Both directives have three optional arguments: ``height``, ``width``
and ``align``. Default height is 281 and default width is 500.
Example::
.. youtube:: anwy2MPT5RE
:height: 315
:width: 560
:align: left
:copyright: (c) 2012 by Danilo Bargen.
:license: BSD 3-clause
From https://gist.github.com/ehles/bed012d78aad5d3cd6c35a49bef32f9f
"""
from __future__ import absolute_import
from docutils import nodes
from docutils.parsers.rst import Directive, directives
def align(argument):
"""Conversion function for the "align" option."""
return directives.choice(argument, ('left', 'center', 'right'))
class IframeVideo(Directive):
has_content = False
required_arguments = 1
optional_arguments = 0
final_argument_whitespace = False
option_spec = {
'height': directives.nonnegative_int,
'width': directives.nonnegative_int,
'align': align,
}
default_width = 500
default_height = 281
def run(self):
self.options['video_id'] = directives.uri(self.arguments[0])
if not self.options.get('width'):
self.options['width'] = self.default_width
if not self.options.get('height'):
self.options['height'] = self.default_height
if not self.options.get('align'):
self.options['align'] = 'left'
return [nodes.raw('', self.html % self.options, format='html')]
class GeneralVid(IframeVideo):
html = '<iframe src="%(video_id)s" width="%(width)u" height="%(height)u" frameborder="0" webkitAllowFullScreen mozallowfullscreen allowfullscreen class="responsive" referrerpolicy="no-referrer" scrolling="no"></iframe>'
class Youtube(IframeVideo):
html = '<iframe src="https://www.youtube-nocookie.com/embed/%(video_id)s" \
width="%(width)u" height="%(height)u" frameborder="0" \
webkitAllowFullScreen mozallowfullscreen allowfullscreen \
class="responsive" referrerpolicy="no-referrer" scrolling="no"></iframe>'
def setup(builder):
directives.register_directive('youtube', Youtube)
directives.register_directive('generalvid', GeneralVid)

Binary file not shown.

After

Width:  |  Height:  |  Size: 134 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 82 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 365 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 189 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 197 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 100 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 38 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 98 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

BIN
attachment/doc/add-ons.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

View file

@ -0,0 +1,225 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/PR-SVG-20010719/DTD/svg10.dtd">
<svg width="25cm" height="16cm" viewBox="-1 -1 482 306" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<g>
<rect style="fill: #ffffff" x="170" y="0" width="310" height="290"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="170" y="0" width="310" height="290"/>
</g>
<g>
<rect style="fill: #ffffff" x="180" y="20" width="100" height="220"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" x="180" y="20" width="100" height="220"/>
</g>
<g>
<rect style="fill: #ffffff" x="0" y="0" width="150" height="160"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="0" y="0" width="150" height="160"/>
</g>
<g>
<rect style="fill: #ffffff" x="0" y="170" width="150" height="70"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="0" y="170" width="150" height="70"/>
</g>
<text font-size="10.16" style="fill: #000000;text-anchor:start;font-family:League Spartan;font-style:normal;font-weight:700" x="0" y="9.4">
<tspan x="0" y="9.4"> mgmt-1</tspan>
<tspan x="0" y="22.1"> (gui-domain?)</tspan>
</text>
<text font-size="10.16" style="fill: #000000;text-anchor:start;font-family:League Spartan;font-style:normal;font-weight:700" x="0" y="179.4">
<tspan x="0" y="179.4"> mgmt-2 ...</tspan>
<tspan x="0" y="192.1"> (remote?)</tspan>
</text>
<text font-size="10.16" style="fill: #000000;text-anchor:start;font-family:League Spartan;font-style:normal;font-weight:700" x="170" y="9.4">
<tspan x="170" y="9.4"> dom0</tspan>
</text>
<g>
<polygon style="fill: #ffffff" points="398.279,118.274 438.208,160.053 398.279,201.832 358.35,160.053 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="398.279,118.274 438.208,160.053 398.279,201.832 358.35,160.053 "/>
<text font-size="9.03111" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="398.279" y="162.809">
<tspan x="398.279" y="162.809">qubesd</tspan>
</text>
</g>
<g>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="441.03,160.053 460,160.053 460,220 420,220 420,235.528 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="448.794,155.053 438.794,160.053 448.794,165.053 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="415,227.764 420,237.764 425,227.764 "/>
</g>
<g>
<polygon style="fill: #ffffff" points="398.508,8.58316 438.389,49.6781 398.508,90.773 358.626,49.6781 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="398.508,8.58316 438.389,49.6781 398.508,90.773 358.626,49.6781 "/>
<text font-size="9.03111" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="398.508" y="52.4337">
<tspan x="398.508" y="52.4337">libvirtd</tspan>
</text>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="398.294" y1="115.528" x2="398.357" y2="96.127"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="393.32,107.748 398.287,117.764 403.32,107.78 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="403.332,103.907 398.365,93.891 393.332,103.875 "/>
</g>
<g>
<rect style="fill: #ffffff" x="200" y="60" width="60" height="20"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="200" y="60" width="60" height="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="230" y="72.75">
<tspan x="230" y="72.75">qrexec call</tspan>
</text>
<g>
<ellipse style="fill: #ffffff" cx="310" cy="70" rx="10" ry="10"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="310" cy="70" rx="10" ry="10"/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="260" y1="70" x2="294.529" y2="70"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="286.765,75 296.765,70 286.765,65 "/>
</g>
<g>
<rect style="fill: #ffffff" x="200" y="90" width="60" height="20"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="200" y="90" width="60" height="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="230" y="102.75">
<tspan x="230" y="102.75">qrexec call</tspan>
</text>
<g>
<ellipse style="fill: #ffffff" cx="310" cy="100" rx="10" ry="10"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="310" cy="100" rx="10" ry="10"/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="260" y1="100" x2="294.529" y2="100"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="286.765,105 296.765,100 286.765,95 "/>
</g>
<g>
<rect style="fill: #ffffff" x="200" y="120" width="60" height="20"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="200" y="120" width="60" height="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="230" y="132.75">
<tspan x="230" y="132.75">qrexec call</tspan>
</text>
<g>
<ellipse style="fill: #ffffff" cx="310" cy="130" rx="10" ry="10"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="310" cy="130" rx="10" ry="10"/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="260" y1="130" x2="294.529" y2="130"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="286.765,135 296.765,130 286.765,125 "/>
</g>
<g>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="320,70 340,70 340,160.053 355.528,160.053 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="347.764,165.053 357.764,160.053 347.764,155.053 "/>
</g>
<g>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="320,100 340,100 340,160.053 355.528,160.053 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="347.764,165.053 357.764,160.053 347.764,155.053 "/>
</g>
<g>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="320,130 340,130 340,160.053 355.528,160.053 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="347.764,165.053 357.764,160.053 347.764,155.053 "/>
</g>
<text font-size="9.03111" style="fill: #000000;text-anchor:start;font-family:League Spartan;font-style:normal;font-weight:700" x="180" y="28.4">
<tspan x="180" y="28.4"> qrexec</tspan>
</text>
<g>
<ellipse style="fill: #ffffff" cx="230" cy="190" rx="20" ry="20"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="230" cy="190" rx="20" ry="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="230" y="187.811">
<tspan x="230" y="187.811">policy</tspan>
<tspan x="230" y="197.689">query</tspan>
</text>
<g>
<ellipse style="fill: #ffffff" cx="102.515" cy="62.5154" rx="32.5154" ry="32.5154"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="102.515" cy="62.5154" rx="32.5154" ry="32.5154"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="102.515" y="60.3265">
<tspan x="102.515" y="60.3265">Qubes OS</tspan>
<tspan x="102.515" y="70.2043">Manager</tspan>
</text>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="135.936" y1="65.0813" x2="195.541" y2="69.6576"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="187.417,74.0486 197.77,69.8288 188.183,64.078 "/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="134.741" y1="71.6009" x2="195.696" y2="88.7864"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="186.866,91.492 197.848,89.3932 189.58,81.8672 "/>
</g>
<g>
<ellipse style="fill: #ffffff" cx="44.9693" cy="114.969" rx="24.9693" ry="24.9693"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="44.9693" cy="114.969" rx="24.9693" ry="24.9693"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="44.9694" y="117.719">
<tspan x="44.9694" y="117.719">CLI tools</tspan>
</text>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="70.8961" y1="114.138" x2="195.53" y2="110.143"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="187.93,115.389 197.765,110.072 187.61,105.395 "/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="70.8015" y1="117.474" x2="195.549" y2="129.568"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="187.339,133.796 197.774,129.784 188.304,123.843 "/>
</g>
<g>
<ellipse style="fill: #ffffff" cx="114.969" cy="204.969" rx="24.9693" ry="24.9693"/>
<ellipse style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" cx="114.969" cy="204.969" rx="24.9693" ry="24.9693"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="114.969" y="202.781">
<tspan x="114.969" y="202.781">remote</tspan>
<tspan x="114.969" y="212.659">proxy</tspan>
</text>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x1="135.609" y1="189.199" x2="196.446" y2="142.715"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="193.313,151.402 198.223,141.358 187.242,143.456 "/>
</g>
<text font-size="9.03111" style="fill: #000000;text-anchor:end;font-family:League Spartan;font-style:normal;font-weight:700" x="160" y="268.4">
<tspan x="160" y="268.4">Qubes Admin API</tspan>
</text>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="160" y1="260" x2="160" y2="190.5"/>
<polygon style="fill: #000000" points="162,190.5 160,180.5 158,190.5 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="162,190.5 160,180.5 158,190.5 "/>
</g>
<text font-size="9.03111" style="fill: #000000;text-anchor:end;font-family:League Spartan;font-style:normal;font-weight:700" x="160" y="288.4">
<tspan x="160" y="288.4">qubesd socket API</tspan>
</text>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" x1="160" y1="280" x2="340.913" y2="175.261"/>
<polygon style="fill: #000000" points="341.915,176.992 349.567,170.251 339.911,173.53 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 1; stroke: #000000" points="341.915,176.992 349.567,170.251 339.911,173.53 "/>
</g>
<g>
<line style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 10; stroke: #000000" x1="10" y1="270" x2="89.1025" y2="220.994"/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="85.1358,229.334 91.0034,219.817 79.8693,220.833 "/>
</g>
<g>
<path style="fill: #ffffff" d="M 9.10799 272.906 C 6.00939,272.756 0,275.907 0.845072,282.66 C 1.69014,289.413 5.7277,290.914 7.41785,288.963 C 9.10799,287.012 4.78873,298.417 13.0517,301.419 C 21.3145,304.42 25.5399,299.618 24.3192,296.166 C 23.0986,292.715 31.5493,304.27 35.4929,297.667 C 39.4366,291.064 31.4554,284.761 33.1455,285.662 C 34.8357,286.562 40,285.362 38.3099,274.106 C 36.6197,262.851 21.4084,271.555 23.0986,269.905 C 24.7887,268.254 20.5633,260 15.3052,261.651 C 10.047,263.302 9.674,266.297 9.11062,272.9 L 9.10799,272.906z"/>
<path style="fill: none; fill-opacity:0; stroke-width: 2; stroke-dasharray: 4; stroke: #000000" d="M 9.10799 272.906 C 6.00939,272.756 0,275.907 0.845072,282.66 C 1.69014,289.413 5.7277,290.914 7.41785,288.963 C 9.10799,287.012 4.78873,298.417 13.0517,301.419 C 21.3145,304.42 25.5399,299.618 24.3192,296.166 C 23.0986,292.715 31.5493,304.27 35.4929,297.667 C 39.4366,291.064 31.4554,284.761 33.1455,285.662 C 34.8357,286.562 40,285.362 38.3099,274.106 C 36.6197,262.851 21.4084,271.555 23.0986,269.905 C 24.7887,268.254 20.5633,260 15.3052,261.651 C 10.047,263.302 9.674,266.297 9.11062,272.9 L 9.10799,272.906"/>
<text font-size="12.8" style="fill: #000000;text-anchor:middle;font-family:sans-serif;font-style:normal;font-weight:normal" x="21.0723" y="286.993">
<tspan x="21.0723" y="286.993"></tspan>
</text>
</g>
<g>
<rect style="fill: #ffffff" x="410" y="130" width="30" height="20"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="410" y="130" width="30" height="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="425" y="142.75">
<tspan x="425" y="142.75">ext</tspan>
</text>
<g>
<polygon style="fill: #ffffff" points="395.221,240 450.973,240 450.973,280 389.026,280 389.026,244 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="395.221,240 450.973,240 450.973,280 389.026,280 389.026,244 "/>
<text font-size="9.03111" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="421.548" y="263.822">
<tspan x="421.548" y="263.822">qubes.xml</tspan>
</text>
</g>
<g>
<polygon style="fill: #ffffff" points="314.926,240 371.342,240 371.342,280 308.658,280 308.658,244 "/>
<polygon style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="314.926,240 371.342,240 371.342,280 308.658,280 308.658,244 "/>
<text font-size="9.03111" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="341.567" y="263.822">
<tspan x="341.567" y="263.822">RPC policy</tspan>
</text>
</g>
<g>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="250.992,190 431.72,190 431.72,210 340,210 340,235.528 "/>
<polyline style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" points="335,227.764 340,237.764 345,227.764 "/>
</g>
<g>
<rect style="fill: #ffffff" x="420" y="120" width="30" height="20"/>
<rect style="fill: none; fill-opacity:0; stroke-width: 2; stroke: #000000" x="420" y="120" width="30" height="20"/>
</g>
<text font-size="7.90222" style="fill: #000000;text-anchor:middle;font-family:League Spartan;font-style:normal;font-weight:700" x="435" y="132.75">
<tspan x="435" y="132.75">ext</tspan>
</text>
</svg>

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 846 B

BIN
attachment/doc/ctap.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

841
attachment/doc/ctap.svg Normal file
View file

@ -0,0 +1,841 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg
xmlns:xhtml="http://www.w3.org/1999/xhtml"
xmlns:dc="http://purl.org/dc/elements/1.1/"
xmlns:cc="http://creativecommons.org/ns#"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
width="821"
height="441"
version="1.1"
content="&lt;mxfile userAgent=&quot;Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0&quot; version=&quot;7.6.7&quot; editor=&quot;www.draw.io&quot; type=&quot;device&quot;&gt;&lt;diagram id=&quot;581adbd3-4043-ab63-00c4-0d1109c21ff0&quot; name=&quot;Page-1&quot;&gt;7Vtbj+I2FP41SNuHjrBz5XGYS7dqK612tNrdRxMMpBNi6pgB+utrJzYknATMkDDMqDyg5Ng49vedm49Dz7mbr3/jZDH7i41p0sP98brn3Pcw9gdYfivBphCg0PcLyZTHYy3bCZ7if6kW9rV0GY9pVukoGEtEvKgKI5amNBIVGeGcrardJiypPnVBphQIniKSQOn3eCxmWor8wa7hM42nM/3oEAdFw4hEz1POlql+Xg87k/xTNM+JGUsvNJuRMVuVRM5Dz7njjIniar6+o4nC1sBW/O6xoXU7b05TYfODQPPyQpIlNVPOJyY2Bgy1noXuRrmg6zoKyMh078M5oO3KpMZQNqeCb2QXPZBnfqK1xdW3qx3yjukyK4GO+1pINNvT7dC7FcsLvegGADwAwIrxZwBCtornCUnl3TATnD3TO5Ywnrc5/fwjWyZxkhh5yvLOjbiV8SlYgACdhYAe7qsiJ53KdVTG8+uGc6qjkURQnhJBh0qhMwDrdqZWSIdQ1b7hx8+/y4s+gFuiJSc1nIm5HO4eAdQ1ujWAkySepvI2kuhSKR8q7GNp2re6YR6Px+oxw9UsFvRpQSL1zJV0ZFKWmy5VM+5bk+cd1G7kVLUb+VC93Vpuz1duFyr3hDOJi3RP2E8UwiMur6bq6lNBBZ0vEyJilv4CSNmBgxrga+RLWokfhXQ02SNNyseEhpNoiza0ixoGINoGXeQCdFGd6fgtwOsjAO9QxR6pdrj/SSq3co9JLJfTNpaj0HO9fY+jYk0Y0Siqs4KzwDWt3lFHve1Sxhq1osv+AQz7VbzkGvnmR/nmp+p04+VYEi5uVY6g4ElIlsWRET/GiRnibyrERicmZCmYFDEuZmzKUpL8ydiiQo1JEvLnrWPxQ89JXRePDjzryLHLGQ7RlrElj2hVEeUaplRUbZ+OK6kOJJdTZe8v1cznQED5wmI5l2alGAxuQi9ALs6/nb0Bi2nrMc6KJ55F6lLVkFOtLMQjRyauO2vihU4DD+bRcOzWsmU8hLWNOWEVzqDGxur8mdeGjWFoY0p9nvTtzgAedtLhcSvsQyt8vXlZ2q+xQgStsJGlskkF0KLQoG2LsuYluD5erFgYk2y2DXJWuKMaV4Zbd2W2wHteJ8DvhSXcWVyqCzW2Ecs7KSzVUGkiUJnK4M2YDEC0+IfTNY3UOlgSRxuYEdN0wuRq5mqRoDFOVYGDza9n79JB9PEcy/DTRjoduMcDete1CHx8s+bU79baAMABAGSb7NdlNgI4dFuOcK0wukx9ZgAw+RhVA+cgxvtVg5qtVldFgxD/j7i6vyDktZUxKShAFxLPFCB/UgGhqUzQXFho8gqnFGMuGTycECDUQab2hgUEXL91Mawc2btoDWu5GCBRIJtSh4Xa1melkfdrBUHVxkKvTPHR7n5/TyOK57+2gAAzQnV6k9dGW7S1bXmzuSB6lq2ZoLyXudjWDdqwvfBjui+ELoihC2Prx/JfDaUXS/8VXqX/Qug0B2ZyirY8mN9u0DO85WpimKtWjIomo1Cn6AmkHnXCKSAhMEWcahQ5VpE+eZxCXduobAfQoQKeL30oj0PoDDvc9cHYvKA8UyoFkOh2KxzWo3QRFBDc+17s+LaVLCZswPg6dgzuAYSuP5427QdCGDzbP7iwOwr0904CsZXjfYXDdGCZ/j1RmadGR45K6nht/1zEjleEL0UsfsMXWGpCRrPzs2TvSjcfZox3+iKLPbjX8CJLCKv8Szy5+UqncaaWCPRatd4uxUwuOI6IoD08/OPhZ43+c7KS495+uf+WQZ7eUaX2tDMq5Fi+8uW1QR50SADprlNzd195L5mZI+gqysWejE1EywWfJt+7dR1HfO+WMvtT0LcrpZnXH7osSp4bzE4HdKt5b4CoiwBy5RqJBuNVL8tcLF2svsRkkS0aiipv1mgwKzuD1msw1o4UHva/kGUiAFmv3d7XIHQk7IQNL3J34Vfl7e5PHkVivPsnjfPwHw==&lt;/diagram&gt;&lt;/mxfile&gt;"
id="svg208"
sodipodi:docname="architecture.svg"
inkscape:version="1.0.2 (e86c870879, 2021-01-15)">
<metadata
id="metadata212">
<rdf:RDF>
<cc:Work
rdf:about="">
<dc:format>image/svg+xml</dc:format>
<dc:type
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
<dc:title></dc:title>
</cc:Work>
</rdf:RDF>
</metadata>
<sodipodi:namedview
pagecolor="#ffffff"
bordercolor="#666666"
borderopacity="1"
objecttolerance="10"
gridtolerance="10"
guidetolerance="10"
inkscape:pageopacity="0"
inkscape:pageshadow="2"
inkscape:window-width="1920"
inkscape:window-height="1080"
id="namedview210"
showgrid="false"
inkscape:zoom="1.4640682"
inkscape:cx="472.92629"
inkscape:cy="213.58528"
inkscape:window-x="0"
inkscape:window-y="0"
inkscape:window-maximized="0"
inkscape:current-layer="g206"
inkscape:document-rotation="0" />
<defs
id="defs2" />
<g
transform="translate(0.5,0.5)"
id="g206">
<path
d="M 500,23 V 0 h 320 v 23 z"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path4" />
<path
d="M 500,23 V 200 H 820 V 23"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path6" />
<g
fill="#000000"
font-family="Helvetica"
font-weight="bold"
text-anchor="middle"
font-size="12px"
id="g10">
<text
x="658.90997"
y="15"
id="text8">work</text>
</g>
<g
transform="translate(627.5,163.5)"
id="g16">
<switch
id="switch14">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="44"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 45px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAPHID </xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="22"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text12">CTAPHID</text>
</switch>
</g>
<rect
x="500"
y="114"
width="120"
height="60"
rx="9"
ry="9"
fill="#dae8fc"
stroke="#6c8ebf"
pointer-events="none"
id="rect18" />
<g
transform="translate(515.5,121.5)"
id="g24">
<switch
id="switch22">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="86"
height="27"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 87px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">frontend<xhtml:br />
(HID emulation)</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="43"
y="20"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text20"><tspan
sodipodi:role="line"
id="tspan90"
x="43"
y="20">frontend</tspan><tspan
sodipodi:role="line"
id="tspan92"
x="43"
y="35">(HID emulation)</tspan></text>
</switch>
</g>
<rect
x="650"
y="40"
width="150"
height="120"
rx="18"
ry="18"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect26" />
<g
transform="translate(668.5,92.5)"
id="g32">
<switch
id="switch30">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="111"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 112px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">Browser (CTAP client)</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="56"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text28">Browser (CTAP client)</text>
</switch>
</g>
<path
d="m 644.57,133.14 -19.02,8.78"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path34" />
<path
d="m 649.34,130.94 -4.89,6.11 0.12,-3.91 -3.05,-2.45 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path36" />
<path
d="m 620.78,144.12 4.89,-6.11 -0.12,3.91 3.05,2.44 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path38" />
<rect
x="352.95929"
y="29.943514"
width="133.92751"
height="386.92245"
fill="#d5e8d4"
stroke="#82b366"
pointer-events="none"
id="rect40"
style="stroke-width:0.911286" />
<path
d="m 346.13,235.18 h 73.63 v 64.7 h 73.64"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path42" />
<path
d="m 340.88,235.18 7,-3.5 -1.75,3.5 1.75,3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path44" />
<path
d="m 498.65,299.88 -7,3.5 1.75,-3.5 -1.75,-3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path46" />
<path
d="m 493.4,144.59 h -73.64 v 60 h -73.63"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path54" />
<path
d="m 498.65,144.59 -7,3.5 1.75,-3.5 -1.75,-3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path56" />
<path
d="m 340.88,204.59 7,-3.5 -1.75,3.5 1.75,3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path58" />
<g
transform="translate(383.5,429.5)"
id="g64">
<switch
id="switch62">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="72"
height="41"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 73px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">qrexec policy<xhtml:br />
enforcement<xhtml:br />
in dom0</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="36"
y="-69"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text60"><tspan
sodipodi:role="line"
id="tspan116"
x="36"
y="-69">qrexec policy</tspan><tspan
sodipodi:role="line"
id="tspan118"
x="36"
y="-54">enforcement</tspan><tspan
sodipodi:role="line"
x="36"
y="-39"
id="tspan122">in dom0</tspan></text>
</switch>
</g>
<path
d="m 20,143 v -23 h 320 v 23 z"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path66" />
<path
d="M 20,143 V 320 H 340 V 143"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path68" />
<g
fill="#000000"
font-family="Helvetica"
font-weight="bold"
text-anchor="middle"
font-size="12px"
id="g72">
<text
x="178.91"
y="135"
id="text70">sys-usb</text>
</g>
<g
transform="translate(147.5,163.5)"
id="g78">
<switch
id="switch76">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="44"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 45px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAPHID </xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="22"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text74">CTAPHID</text>
</switch>
</g>
<g
transform="translate(147.5,263.5)"
id="g84">
<switch
id="switch82">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="44"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 45px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAPHID </xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="22"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text80">CTAPHID</text>
</switch>
</g>
<rect
x="0"
y="150"
width="120"
height="60"
rx="9"
ry="9"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect86" />
<g
transform="translate(18.5,164.5)"
id="g92">
<switch
id="switch90">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="80"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 81px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAP HID token</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="40"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text88"><tspan
sodipodi:role="line"
id="tspan253"
x="40"
y="12">CTAP HID token</tspan><tspan
sodipodi:role="line"
id="tspan255"
x="40"
y="27">(CTAP authenticator)</tspan></text>
</switch>
</g>
<path
d="M 213.4,204.59 H 170.35 V 179.88 H 126.13"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path94" />
<path
d="m 218.65,204.59 -7,3.5 1.75,-3.5 -1.75,-3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path96" />
<path
d="m 120.88,179.88 7,-3.5 -1.75,3.5 1.75,3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path98" />
<rect
x="220"
y="190"
width="120"
height="60"
rx="9"
ry="9"
fill="#dae8fc"
stroke="#6c8ebf"
pointer-events="none"
id="rect100" />
<g
transform="translate(255.5,212.5)"
id="g106">
<switch
id="switch104">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="47"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 48px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">backend</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="24"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text102">backend</text>
</switch>
</g>
<rect
x="0"
y="230"
width="120"
height="60"
rx="9"
ry="9"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect108" />
<g
transform="translate(18.5,244.5)"
id="g114">
<switch
id="switch112">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="80"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 81px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAP HID token</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="40"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text110"><tspan
sodipodi:role="line"
id="tspan257"
x="40"
y="12">CTAP HID token</tspan><tspan
sodipodi:role="line"
id="tspan259"
x="40"
y="27">(CTAP authenticator)</tspan></text>
</switch>
</g>
<path
d="m 213.4,235.18 h -43.05 v 24.7 h -44.22"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path116" />
<path
d="m 218.65,235.18 -7,3.5 1.75,-3.5 -1.75,-3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path118" />
<path
d="m 120.88,259.88 7,-3.5 -1.75,3.5 1.75,3.5 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path120" />
<path
d="m 500,263 v -23 h 320 v 23 z"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path126" />
<path
d="M 500,263 V 440 H 820 V 263"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path128" />
<g
fill="#000000"
font-family="Helvetica"
font-weight="bold"
text-anchor="middle"
font-size="12px"
id="g132">
<text
x="658.90997"
y="255"
id="text130">personal</text>
</g>
<rect
x="500"
y="270"
width="120"
height="60"
rx="9"
ry="9"
fill="#dae8fc"
stroke="#6c8ebf"
pointer-events="none"
id="rect134" />
<g
transform="translate(515.5,277.5)"
id="g140">
<switch
id="switch138">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="86"
height="27"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 87px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">frontend<xhtml:br />
(HID emulation)</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="43"
y="20"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text136"><tspan
sodipodi:role="line"
id="tspan94"
x="43"
y="20">frontend</tspan><tspan
sodipodi:role="line"
id="tspan96"
x="43"
y="35">(HID emulation)</tspan></text>
</switch>
</g>
<path
d="m 643.95,307.86 -18.14,-5.98"
fill="none"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path142" />
<path
d="m 648.94,309.51 -7.75,1.13 2.76,-2.78 -0.56,-3.87 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path144" />
<path
d="m 620.83,300.23 7.74,-1.13 -2.76,2.78 0.57,3.87 z"
fill="#000000"
stroke="#000000"
stroke-miterlimit="10"
pointer-events="none"
id="path146" />
<g
transform="translate(515.5,365.5)"
id="g160">
<switch
id="switch158">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="86"
height="27"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 87px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">frontend<xhtml:br />
(HID emulation)</xhtml:div>
</xhtml:div>
</foreignObject>
</switch>
</g>
<rect
x="650"
y="280"
width="150"
height="120"
rx="18"
ry="18"
fill="#f8cecc"
stroke="#b85450"
pointer-events="none"
id="rect162" />
<g
transform="translate(668.5,332.5)"
id="g168">
<switch
id="switch166">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="111"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 112px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">Browser (CTAP client)</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="56"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text164">Browser (CTAP client)</text>
</switch>
</g>
<g
transform="translate(360.5,98.5)"
id="g174">
<switch
id="switch172">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="119"
height="41"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 120px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">u2f.Register<xhtml:br />
u2f.Authenticate+KEY<xhtml:br />
(raw APDUs)</xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="60"
y="-39"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text170"><tspan
sodipodi:role="line"
id="tspan100"
x="60"
y="-39">ctap.GetInfo</tspan><tspan
sodipodi:role="line"
x="60"
y="-24"
id="tspan112">ctap.ClientPin</tspan><tspan
sodipodi:role="line"
x="60"
y="-9"
id="tspan114">u2f.Register</tspan><tspan
sodipodi:role="line"
x="60"
y="6"
id="tspan104">u2f.Authenticate+KEY</tspan><tspan
sodipodi:role="line"
x="60"
y="21"
id="tspan106">(raw CBOR/APDU)</tspan></text>
</switch>
</g>
<g
transform="translate(59.5,452.5)"
id="g182">
<switch
id="switch180">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="99"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 100px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAP HID softtoken</xhtml:div>
</xhtml:div>
</foreignObject>
</switch>
</g>
<g
transform="translate(255.5,452.5)"
id="g190">
<switch
id="switch188">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="47"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 48px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">backend</xhtml:div>
</xhtml:div>
</foreignObject>
</switch>
</g>
<g
fill="#000000"
font-family="Helvetica"
font-weight="bold"
text-anchor="middle"
font-size="12px"
id="g204" />
<g
transform="translate(599.78076,342.20152)"
id="g16-3">
<switch
id="switch14-6">
<foreignObject
style="overflow:visible;"
pointer-events="all"
width="44"
height="12"
requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility">
<xhtml:div
style="display: inline-block; font-size: 12px; font-family: Helvetica; color: rgb(0, 0, 0); line-height: 1.2; vertical-align: top; width: 45px; white-space: nowrap; overflow-wrap: normal; text-align: center;">
<xhtml:div
style="display:inline-block;text-align:inherit;text-decoration:inherit;">CTAPHID </xhtml:div>
</xhtml:div>
</foreignObject>
<text
x="22"
y="12"
fill="#000000"
text-anchor="middle"
font-size="12px"
font-family="Helvetica"
id="text12-7">CTAPHID</text>
</switch>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 28 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

BIN
attachment/doc/dislike.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 557 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 247 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 128 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 179 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 167 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 122 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 99 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 104 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1,016 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 17 KiB

BIN
attachment/doc/grub1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

BIN
attachment/doc/grub2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

BIN
attachment/doc/grub3.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

BIN
attachment/doc/gui.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 433 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 444 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 78 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 131 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 108 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

BIN
attachment/doc/ipv6-1.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

View file

@ -0,0 +1 @@
<mxfile userAgent="Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:57.0) Gecko/20100101 Firefox/57.0" version="8.0.2" editor="www.draw.io" type="device"><diagram id="32a8e41c-a064-97f3-9a90-4db0e0e6f5c1" name="Page-1">5VjbctsgEP0aPaYjgyTLj7GTXmbaTmby0OQRS2uJBgsVocjq1xcJbF2wM27i3No8ZOCwu8A5y4Ls4MV680mQPP3GY2AOcuONgy8chDzPVf8boNZAOMMaSASNNTTpgGv6Gwxo/JKSxlAMDCXnTNJ8CEY8yyCSA4wIwauh2Yqz4aw5ScACriPCbPQHjWVqduG7Hf4ZaJJuZ564ZmRJortE8DIz8zkIr9o/Pbwm21jGvkhJzKsehC8dvBCcS91abxbAGmq3tGm/jwdGd+sWkMljHJB2uCesNFsv6uIsA+mggKkI86VQraRp0fw+UCZmikLWW7La7ULcjuF5lVIJ1zmJmtFKZYfCUrlmZnhFGVtwxkXri2MfwthTeCEFv4PeSIiWOFATzs0KQUjYHNzlZMedSknga5CiViabYVrVO7l0v+q0nWwVSXu6BgYjJp2SXeSOUtUwrB6QxCYMYpVspsuFTHnCM8IuO3TeUeoO6YMNlTe99m1j8sFvepla2I3xaDvd2E+QsjanjJSSK6ib9yvnuYmoV9os72Gi1W54KSJjZY62JCIBYzXdL4cARiS9H0bfR27rei4EqXsGOaeZLCzud/GPkwM9vxzozekRPq8eJvJVA/ROHR4eO6sWje0D/0n2E88dJYde8aNTBf+HJ3f2KpnyROWD0wqP916KKyqgIo3hu7//Zi94/3kWmd91JiH3y5V6UVhHjDH1ymuOknob5Q0YMV7G74TZI4kNT0CsbxFrc5nF581ruCWRFAWNRjVpV3m6QnRrCtHxFaVfPtB+tnp8+Hvo2GJ/V2WssjAdihEGwwC68hmfB6pLMLq2piOx9H6tOI8oNMFbkbB/KSBbVfyaqo6OGEYjOd6erFNLVvXt5J3xjNVnv8olHPy2OunVsgojiKJ9BXAZ+p7vnqYAIvcV75bQIjoHUTRPo3d4SVtMvuRX6sxisuLi7h9gET8fiarb/VCjy0T3Yxi+/AM=</diagram></mxfile>

BIN
attachment/doc/ipv6-2.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

View file

@ -0,0 +1 @@
<mxfile userAgent="Mozilla/5.0 (X11; Fedora; Linux x86_64; rv:57.0) Gecko/20100101 Firefox/57.0" version="8.0.2" editor="www.draw.io" type="device"><diagram id="144a4769-0002-f4b6-27d0-e28edd050a98" name="Page-1">1VjLcpswFP0alukghDFe1m76mGlnMpNFk6UMMtDIiBGyMf36SiAeQrhDEj9iLzzS0b1CnHN1r4QFV9vDN4ay+BcNMbEcOzxY8IvlOK5ri38JlDXgL2ANRCwJawh0wGPyFytQ+UW7JMS5ZsgpJTzJdDCgaYoDrmGIMVroZhtK9KdmKMIG8BggYqK/k5DH6i1mdod/x0kUN08GthpZo+AlYnSXqudZDtxUv3p4i5q5lH0eo5AWPQjeW3DFKOV1a3tYYSKpbWir/b4eGW3XzXDKpzg4tcMekZ169bzM71LM1fJ42VBSvRSWbsCCyyJOOH7MUCBHCxEDAov5lqjhTULIihLKKl+48QMcBALPOaMvuDey9meuYBUu1Tow4/hw9F1Ay5AIPEy3mLNSmBz04ClbUep+0SkIGt7jnnqewpAKmqiduSNONBR34zxCgy8ciohSXcp4TCOaInLfocuOUVtnDx8S/tRrP0uTTzPZS8W6npRH1enG/mDOS7WV0I5TAXXP/UlppmasVyqXp/Gc0x0LFORNpp5hgniy16caI7Jy/cwYKnsGGU1SnusB+iCxTlTH1lVtd04zB0cswlx5DQRrFzpJQ+CfQ0QlnJIRaCJ2mj6rCd4poqHYqK41ZcrKe6ewU3cIWNz8FnkDu/BC7HqjeXyTMFwgaXjzyXxxwWQ+N8j88bB3BSLqYkHZixnIhIiTiQxYUc8zCQaE7sIboXYis/4JmPUNZk0u0/CzPMFVJKI8T4LBzv9P9jyyb/s70pnMVo+P2QgdDfa6CmjUt7kuhu/pE9T5xahuxjTeoErOz1YlF1eRsJ9nHVPV6QeWy6g62GJweGj5eLICYOiaYZbLwnjS6hHOsB+6YynOd9bQ806U4uZXvAsA81I1WjVuj0Z4SRZdM6+c9bwIrAufFwE0Exk48z1rPM1AMH7JOpaWhvbAtQfS1it4czKanV/7+QcU37mG+M7ifeK/1t47caxAI9vKqw/HDIfUcjwiyF2umWhFspVke68S7vaz8UXvRMC8YQoq3TuakvKkXF7lDtQerM5Apeh233PrAO++mcP7fw==</diagram></mxfile>

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

BIN
attachment/doc/like.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 540 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 762 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 70 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 280 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 245 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 661 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 502 KiB

Some files were not shown because too many files have changed in this diff Show more