quick{emu,get}: add page (#12029)

* quick{emu,get}: add pages

* quick{emu,get}: apply suggestions from code review

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* quickget: fix wording

Co-authored-by: Juri Dispan <juri.dispan@posteo.net>

* quick{emu,get}: apply suggestions from code review

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

* quickemu: enclose "sdl" with backticks

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

* Update pages/linux/quickemu.md

Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Juri Dispan <juri.dispan@posteo.net>
Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
Co-authored-by: Jack Lin <blueskyson1401@gmail.com>

pages/linux/quickemu.md

@@ -0,0 +1,33 @@
+# quickemu
+
+> Build and manage highly optimised desktop virtual machines quickly.
+> See also: `quickget`, for preparing VM configurations.
+> More information: <https://github.com/quickemu-project/quickemu>.
+
+- Create and run a virtual machine from a configuration file:
+
+`quickemu --vm {{path/to/file.conf}}`
+
+- Do not commit any changes to disk/snapshot but write any changes to temporary files:
+
+`quickemu --status-quo --vm {{path/to/file.conf}}`
+
+- Start the virtual machine in full-screen mode (<Ctrl> + <Alt> + f to exit) and select the display backend (`sdl` by default):
+
+`quickemu --fullscreen --display {{sdl|gtk|spice|spice-app|none}} --vm {{path/to/file.conf}}`
+
+- Select a virtual audio device to emulate and create a desktop shortcut:
+
+`quickemu --sound-card {{intel-hda|ac97|es1370|sb16|none}} --shortcut --vm {{path/to/file.conf}}`
+
+- Create a snapshot:
+
+`quickemu --snapshot create {{tag}} --vm {{path/to/file.conf}}`
+
+- Restore a snapshot:
+
+`quickemu --snapshot apply {{tag}} --vm {{path/to/file.conf}}`
+
+- Delete a snapshot:
+
+`quickemu --snapshot delete {{tag}} --vm {{path/to/file.conf}}`

pages/linux/quickget.md

@@ -0,0 +1,34 @@
+# quickget
+
+> Download and prepare materials for building a Quickemu virtual machine.
+> NOTE: the parameter "edition" is always optional.
+> See also: `quickemu`.
+> More information: <https://github.com/quickemu-project/quickemu>.
+
+- Display the list of all supported guest operating systems, versions and variants:
+
+`quickget list`
+
+- Download and create the virtual machine configuration for building a Quickemu virtual machine for an OS:
+
+`quickget {{os}} {{release}} {{edition}}`
+
+- Download configuration for a Windows 11 VM with VirtIO drivers for Windows:
+
+`quickget windows 11`
+
+- Download a macOS recovery image and creates a virtual machine configuration:
+
+`quickget macos {{high-sierra|mojave|catalina|big-sur|monterey|ventura}}`
+
+- Show an ISO URL for an operating system (Note: it does not work for Windows):
+
+`quickget --show-iso-url fedora {{release}} {{edition}}`
+
+- Test if an ISO file is available for an operating system:
+
+`quickget --test-iso-url nixos {{edition}} {{plasma5}}`
+
+- Open an operating system distribution's homepage in a browser (Note: it does not work for Windows):
+
+`quickget --open-distro-homepage {{os}}`