Page MenuHomeFreeBSD

Article - Create new KDE Plasma install guide
Needs RevisionPublic

Authored by carlavilla on Jan 18 2025, 9:23 AM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, May 6, 4:04 PM
Unknown Object (File)
Wed, Apr 23, 3:09 PM
Unknown Object (File)
Wed, Apr 23, 9:15 AM
Unknown Object (File)
Tue, Apr 22, 10:49 PM
Unknown Object (File)
Thu, Apr 17, 7:57 PM
Unknown Object (File)
Apr 7 2025, 2:01 PM
Unknown Object (File)
Mar 28 2025, 9:45 PM
Unknown Object (File)
Mar 1 2025, 8:41 AM

Details

Summary

The idea of ​​this series of articles [WIP] is to create customized and complete guides on how to install and configure the different desktops in FreeBSD: KDE Plasma, Gnome, MATE.

This article is WIP.

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped

Event Timeline

carlavilla created this revision.
documentation/content/en/articles/kde-plasma-desktop/_index.adoc
92

The command below does not update the Ports tree. It updates the package list and all the installed packages, respectively.

112

This command is overloaded with multiple concepts.

The pkg install drm-kmod part is about installing and configuring a graphcis driver. It also implies that an user runs Intel or AMD graphics, because NVIDIA DRM driver is provided by the separate drm-nvidia-kmod kmod.

The pkg install xorg command implies that an user is going to use X11 rather than Wayland. At the moment it is indeed the best choice for Plasma, but it may change it future.

The pkg install sddm part is installing a display manager. SDDM is supported pretty well and also has an integration with Plasma. But again, it is not the only choice and user may want to install a different DM. There is also the "startx" method of starting the graphical session, which is popular amongst developers. It might be worth documenting it too.

So, maybe these three concepts should be put outside of this article or at least separated from the "KDE Plasma Installation" paragraph, as it is not really specific to Plasma.

112

And speaking of xf86-input-evdev - I'm not sure if it is really required. At least the upcoming Plasma 6 already has a dependency on this package, so it can be omitted.

166

SDDM can also be localized with

sysrc sddm_lang="ru_RU"
171

Continuing from my previous comment, maybe this section should come before the "Plasma Installation"?

215

Alt+F2 -> System Settings -> "Appearance & Style" section.

It allows changing the wallpaper and its type, change the default fonts and DE theme settings.

documentation/content/en/articles/kde-plasma-desktop/_index.adoc
50

According to: https://docs.freebsd.org/en/books/fdp-primer/book/#writing-style-be-clear

Write in a formal style. Avoid addressing the reader as "you".

This should apply to the whole article.

73

Link for "Install" chapter in the handbook.

107

For these applications for which we do have separate ports, add the links here.

174

Replace first username with username and split the second one as "user name", so it is clear the first is a parameter and the second one is not.

236

Link to the referred Handbook chapter.

yklaxds_gmail.com added inline comments.
documentation/content/en/articles/kde-plasma-desktop/_index.adoc
112

Based on practical testing, for the graphics card of 12th-generation processors, it must be installed via ports rather than pkg, and the specific port drm-61-kmod must be installed instead of drm-kmod.

Will review again as TODOs get filled out.

documentation/content/en/articles/kde-plasma-desktop/_index.adoc
48

Or some other wording that doesn't sound as much like advertising copy.

50
64

For consistency with the "x86" designators (as opposed to "i386"/"amd64")..

73

A link (with text "Install chapter in the FreeBSD Handbook") would be good here.

89

Also, isn't the recommendation to run fetch and install as separate commands? In that case, perhaps

freebsd-update fetch
freebsd-update install

?

118
127
137

Unless the intended audience would understand "inter-process communication (IPC) system".

231

I'd remove that line, both because it was already said and (again) it sounds like advertising, not technical documentation.

234

Ditto.

237

I'd get rid of that line, which sounds too breezy in tone.

This revision now requires changes to proceed.Jan 21 2025, 2:23 PM
documentation/content/en/articles/kde-plasma-desktop/_index.adoc
64

Nack. The project uses aarch64 everywhere.

Btw, i agree with you, and I strongly dislike this choice. FreeBSD/i386 doesn't even run on i386, it only runs on i686, so it should be called ia32, and armv8/9 should be called arm64. But, we have to be consistent.

96

pkg upgrade will also update the package list unless it has just been done fairly immediately.

112

Hopefully drm-kmod issue will get resolved.

documentation/content/en/articles/kde-plasma-desktop/_index.adoc
64

Problem is, this sentence as it is now is internally inconsistent (it uses "aarch64" as the project but "x86*' unlike it). I can see the point for making it clearer to newcomers by using "x86*", but in that case it should also use "arm64". Or, stick to "aarch64" (perhaps with a clarification) *and* use Project terminology throughout the sentence.

documentation/content/en/articles/kde-plasma-desktop/_index.adoc
48

Can we find a middle ground and explain what KDE is, why the reader would want it? For example, xfce is also a modern fully featured desktop, but they're very different.

64

Using consistent project terminology throughout sgtm!

92
127

Can we suggest them using graphics/nvidia-drm? When i switched to nvidia-drm, I got an extra *hour* of battery life because of working PRIME. Also, something something follow the instructions in the pkg-msg? I.e. they need to enable hw.nvidiadrm.modeset in loader.conf or nothing will work.

133

This may also be a better place than above to mention enabling modesetting in loader.conf, a required step.

137

The doc is explaining it. I think doc should teach without becoming burdensome. Alternatively, we can do something with the glossary here?
E.g. "D-Bus is an IPC(glossary link) software that allows applications and desktop components to communicate and interact seamlessly".