Differences

This shows you the differences between two versions of the page.

--- batocera_wiki_code_snippets [2022/08/16 13:43] – Add: Syntax for the newly added "imagebox" DokuWiki plugin. grandmabetty
+++ batocera_wiki_code_snippets [2023/10/20 06:02] (current) – [Embedded images]: Explain how to avoid font issues in SVG ssokolow
@@ Line 109: / Line 109: @@
 {{:wiki:svg-controller.svg|Cute controller.}}
-The wiki's media manager can actually accept SVG files even though it doesn't show it on the compatible file formats list. SVG files that contain text are discouraged due to fonts not being available on all systems (and thus appearing inconsistently or not at all).
+The wiki's media manager can actually accept SVG files even though it doesn't show it on the compatible file formats list. SVG files that contain text are discouraged due to fonts not being available on all systems (and thus appearing inconsistently or not at all). You can avoid this by converting the text into shapes in Inkscape using ''Path > Object to Path''.
-However, by using the official DokuWiki [[https://www.dokuwiki.org/plugin:imagebox|imagebox]] plugin (which is installed additionally on this DokuWiki server), you can also put a frame around an image and make the image title text show up within the image frame instead of showing up as a tooltip (the image's filename will be shown as a tooltip instead). If you decide to resize your image like the image example below (75% of the image's oroginal size), the plugin also includes a nice extra feature of showing automatically an extra mini icon on the right lower corner of your imagebox you can click on to enlarge the image to its original size.
+However, by using the official DokuWiki [[https://www.dokuwiki.org/plugin:imagebox|imagebox]] plugin (which is installed additionally on this DokuWiki server), you can also put a frame around an image and make the image title text show up within the image frame instead of showing up as a tooltip (the image's filename will be shown as a tooltip instead). If you decide to resize your image like the image example below (75% of the image's original size in this example), the plugin also includes a nice extra feature of showing automatically an extra mini icon on the right lower corner of your imagebox you can click on to enlarge the image to its original size.
 [{{ wiki:dokuwiki-128.png?75 |This is the image title}}] \\
   [{{ wiki:dokuwiki-128.png?75 |This is the image title}}]
+===== Embedded videos =====
+It is recommended to convert the video to a WEBM with a resolution of 655x368 to prepare it for embedding into the wiki page and not have interruptions during playback. With that said, the wiki supports many video formats (check what you can upload in the media uploading tool) and the resolution will always be downscaled to whatever size you specify in the embed code itself. For example:
+<code>
+{{URL-to-video?655x368|Alt text}}
+</code>
+This would result in the video looking similar to this:
+{{blog:how-to-install-windows-steam-games.webm?655x368|Sometimes running a game through Proton is even better than its Linux-native version!}}
+<WRAP center round tip>
+A quick way to record videos from Batocera itself is to sign in via SSH and run the ''batocera-record'' command.
+</WRAP>
 ===== Unformatted code =====
@@ Line 298: / Line 314: @@
 <--
+===== File tree ASCII art =====
+When you need to display a folder's structure, the best way to do so is via an ASCII tree in a code block like so:
+<code>
+roms/
+├─ psx/
+│  ├─ Final Fantasy VII (Disc 1).bin
+│  └─ Final Fantasy VII (Disc 1).cue
+└─ Final Fantasy VII (Disc 1).m3u
+</code>
+Although it may be fun to write these out yourself, an automatic tool to create them is available at https://ascii-tree-generator.com/
 ===== CSV SAMPLE OUTPUT GOOGLE =====
@@ Line 320: / Line 350: @@
   - Copy the link (check it ends with output=csv) and paste it into your dokuwiki CSV table using the file= attribute described above.
 </WRAP>
+===== Embed a website into a wiki page =====
+Batocera wiki supports iframes, showing another web page inside of the article. Simple example:
+<code>
+{{url>http://www.example.com/somepage.html}}
+</code>
+Full syntax:
+<code>
+{{url>someurl width,height noscroll noborder alignment|alternate-text}}
+</code>
+Javascript URLs are not supported. More info at https://www.dokuwiki.org/plugin:iframe
 ===== Templates =====