UB
Universal Bluetryhardsoccermomswag

bluefin-help

https://discord.com/channels/1072614816579063828/1087140903031943178/1214633597227634688 @bketelsen i am playing around with this for bazzite documentation right now, thanks for making this!
T
tryhardsoccermomswag41d ago
No description
N
Noel41d ago
So is this an app that runs on the desktop?
T
tryhardsoccermomswag41d ago
well... if you include GNOME's yelp application then yes it's essentially GNOME Help but you can change the text with mallard markup language i am running into a percuilar bug where each time i launch it, the window height increases on KDE plasma almost comically
J
j0rge41d ago
hey @bketelsen could we make an action that slurps every post on the forum tagged with documentation, converts it from markdown to a format mallard expects, and then we copy it onto disk in the image. and then the same for the KDE help thing then we're done
B
bketelsen41d ago
@Noel it's yelp which is already included on the desktop, my demo repo just includes tools to create & compile the help docs the output can be many formats, but epub is the most compact and easy to drop on to one of our images we can do anything we set our minds to
T
tryhardsoccermomswag41d ago
kyle found a html2mallard python package, but it's not liking it so far 😄 i honestly wouldn't mind doing it by hand manually, even if it might take me a couple of weeks. jorge suggested it would be easier to do all of that above by scraping the discourse documentation. far easier and automated which is what we like, but im not sure how much easier it would be. it seems to be very particular, but i think i need to understand and learn what im doing better
T
tryhardsoccermomswag41d ago
so far i have this mess lol but im honestly shocked i got this far
No description
T
tryhardsoccermomswag41d ago
^this is all manually if i try the markdown from the discourse conversion the page refuses to load should mention that it's only included on GNOME images ofc you made this for bluefin originally 😅
T
tryhardsoccermomswag41d ago
KDE has their own fun Qt Help application
No description
T
tryhardsoccermomswag41d ago
KDE's KHelpCenter uses DocBook while GNOME's Yelp uses Mallard writing all of this down here so all of that information is here if we need it for anything anyways this is a great project bketelsen
F
fiftydinar40d ago
@nickname Edit: my bad, not a default, I made a mistake in reading For your information, this will be the default help app for Gnome 46: https://flathub.org/apps/app.drey.Biblioteca Fedora usually delays Gnome default apps choice or in some cases, don't implement them at all (Terminal vs BlackBox situation)
Flathub - Apps for Linux
Install Biblioteca on Linux | Flathub
Documentation viewer for GNOME
T
tryhardsoccermomswag40d ago
:build_failed:
No description
T
tryhardsoccermomswag40d ago
PyPI
html2mallard
convert mkdocs´ html output to mallard/yelp xml
T
tryhardsoccermomswag40d ago
you can take the markdown documentation from the docs on discourse, paste them into a file and make sure it's a .md file. convert it to mallard and then fix any issues it has by hand it's not perfect by any means, but it's faster this way
T
tulip37d ago
sweet! its also works offline, doesnt it? this is so cool
T
tryhardsoccermomswag37d ago
yea i still need to do a lot but it's nice
T
tulip37d ago
super sweet but like
N
Noel37d ago
You are kicking ass my friend. Love all the work you have been putting into the documentation and new user experience.
T
tulip37d ago
are you copying each page and converting it?
N
Noel37d ago
I was wondering the same thing.
T
tulip37d ago
seems to be really annoying if thats the case probably could write a scraper for that
T
tryhardsoccermomswag37d ago
im using html2mallard to convert the markdown files to mallard, but i have to edit them anyways since it's not perfect by any means lol
T
tulip37d ago
what do you need to edit? is it just styling or info in general?
T
tryhardsoccermomswag37d ago
both
T
tulip37d ago
okok
T
tryhardsoccermomswag36d ago
most of the work has already been done by bketelsen's bluefin-tools lol i am only forking it and adding documentation relevant to bazzite i can help with the bluefin docs too. im almost done with the bazzite docs (hopefully) but like i can use html2mallard, fix up any errors that have made and format it properly for the bluefin documentation too
J
j0rge35d ago
This looks really awesome!!! @nickname what do we need to pull this in? Working on ISO things tonight so might as well get this in there
T
tryhardsoccermomswag35d ago
yelp and possibly yelp-tools idk how to connect it all though. i didnt exactly fix up the docs yet like i said, i will tonight when im on my desktop. been waiting for a phone call all day so far it works if you cd into the directory of the docs
J
j0rge35d ago
oh ok so maybe we just have to copy some files into the right directories?
T
tryhardsoccermomswag35d ago
when i actually do them the reference files I PR'd yesterday most likely wont function
J
j0rge35d ago
understood!
T
tryhardsoccermomswag35d ago
they can be edited directly pretty easily it's all formatting stuff
T
tryhardsoccermomswag27d ago
No description
T
tryhardsoccermomswag27d ago
No description
T
tryhardsoccermomswag27d ago
https://github.com/nicknamenamenick/bazzite-help/tree/bluefin-help if anyone wants to see this for themselves, here it is
GitHub
GitHub - nicknamenamenick/bazzite-help at bluefin-help
(WIP) Bazzite documentation for GNOME images. Contribute to nicknamenamenick/bazzite-help development by creating an account on GitHub.
T
tryhardsoccermomswag27d ago
i didnt edit any of the bluefin docs, so they are not formatted correctly (yet) but you can see how this works and how i plan to have it 'formatted' on the main index page
B
bketelsen27d ago
wow!
J
j0rge26d ago
Awesome!! On the road but loving how it looks!
T
tryhardsoccermomswag13d ago
So no rush to do this, but eventually, would a KHelpCenter? Instead of Mallard, it uses DocBook for their XML. I see this is utilizing yelp-tools but I'm not sure if the same thing can be made with KDE's help application. This is an amazing tool bketelsen! i will be returning to this endeavor soon
Want results from more Discord servers?
Add your server
More Posts
Gradience fails to apply themes. "OSError Read-only file system"The Gradience flatpak refuses to apply any themes I give it, whether it's my generated ones or the omy 18 year old cousin borrowed itRan a system update after I got it back today and saw this, we have been trying to get stream play wpaste in your image page in your repopaste in your image page in your repowaydroid-choose-gpu: no such file or directoryi have a gaming laptop so i would want to choose the nvidia gpu that i have for working with waydroiUpgrade lactHow can I upgrade my lact? I try running `ujust install-lact` again but got the error below: ``` erBazzite installation ultimately failsWhile installing Bazzite (Legion Go, GNOME DE, stable) as a dualboot manual install, the installer nWeird 1Password & Flatpak Browser InteractionBazzite 39, fresh KDE install, no gamemode. I'm new to Universal Blue and have been having a good tiLegion go upscale steam issue deskstop modeSo i upscale steam on desktop mode and when i summon the keyboard it shows halfway is there a comman“steam button” can’t be held down (ROG ALLY)The system is emulating a PS5 controller and I’m not able to hold down the “steam button” (the buttoPreferred method for connecting second drive to steam?Both drives were connected when I installed bazzite-deck, second drive is mounted and shows up in deSet up screen wont appearWhen i try to boot off of a usb to install it wont work it runs some commands then turns offBluefin build issuesBluefin build issues452 out of range pointer. HELP!!!!!!!Hi there I’m trying to download bazzite to my hp compaq elite 8300 small form factor and I can everyI'm running old gtk app easytag in KDE but it loads the wrong theme, can't read the textHow can I make old gtk apps load the dark theme and show text properly?Wifi 6eIs there something I need to do to enable wifi 6e on Bazzite? My device is a Rog Ally. I am not ableamdgpuHello I have an AMD Radeon R9 M470X its in an Alienware Alpha R2.. I get a black screen when rebootibluefin-cli on bluefin threadbluefin-cli on bluefin threadGrub Menu No Longer AppearingI recently set up this system and all has been going well. I have windows installed to a 2nd SSD forBazzite-stable & bazzite-nvidia installs can't get past "Updating kargs"I have spent most of my weekend testing different bios presets and different ISOs and different usb Legion go - no speaker outputJust picked up my legion go after a few days and applied the latest update. Speaker output is silent