Code Monkey home page Code Monkey logo

wiki's Introduction

Ultramarine Linux Wiki

Welcome to the source repository behind the Ultramarine Wiki! We welcome any contributions and you may freely send pull requests to this repository if you would like to modify any of the content here!

Translations

If you'd like to translate for a new language:

  1. Go to src/consts.ts to add a new language into KNOWN_LANGUAGES
  2. Copy everything from src/content/docs/en to src/content/docs/<your_language_code>1
  3. Add pages into SIDEBAR in src/consts.ts
  4. Start translating!

Footnotes

  1. We encourage you to use a generic language code without limiting the region. โ†ฉ

wiki's People

Contributors

nothingneko avatar trobonox avatar madonuko avatar lleyton avatar korewachino avatar vehementham avatar owen-sz avatar phredmund avatar kyweehz avatar flatbread1 avatar matteodev8 avatar imgbotapp avatar rico-vz avatar roraharvest avatar

Stargazers

Septicuss avatar  avatar  avatar Sefa Bulak avatar  avatar  avatar

Watchers

 avatar  avatar

wiki's Issues

`shell.mdx` missing instrictuons on how to use important commands commands.

https://wiki.ultramarine-linux.org/en/linux/shell/ is missing instructions for the cp, ln and ls commands. It is also worth mentioning the ln command and the ls command.

For cp mention the -r flag as well.

For ln, mention how simlinks are relative, and provide an axample for ln -s. There is no need to mention hard links.

For ls, mention the -a flag and -l flags.

These are all critical to using the command line. Much more so than touch, which is mentioned.

Expanding the wiki (Ideas)

Expanding the wiki

I have put together a list of ideas in case the commity of Ultrumarine Linux wishes to expand the wiki.

First of all, I'd like to say, that I think the idea of a centralized wiki where the user can go and learn about their system, is a genius idea, because all of the information is optimized for Ultramarine Linux specifically. That is what this community has accomplished.

Because this wiki is very well-made, and thought out, I think that the users would benifit from more of it. If the community was to expand the wiki, here are some pages ideas that I would think could be a prority:

git

git is one of the most difficult commands in Linux. It would be extremely benifitial if the user could conveniently, and properly learn how to use it in this wiki. This page would provide instructions on how Git works, and how to use it from the command line. It would also go in depth on how to properly authenticate with ssh tokens and whatnot. It will go over common issues that users have. All while remaining breif and consise. If users wish to learn more about Git, the page will have links to the Pro Git book, and the Github docummentation.

ssh

Another important command on Linux which users find scary. The page would include information on connecting to other systems via ssh, and mounting a system with sshfs. It would also include configuration instructions.

Installing applications

Detailed instructions on the different ways to install applications. This includes flatpaks, snaps, appimages, nix home manager, pkgsrc, distrobox containers, and an in depth look at Fedoras package management system; copr, rpms, dnf.

Disk management

An explanation on disk management. Details on how to partition, mount, create and change file sytsems. Instructions for gparted, and command line applications.

gpg

I don't know much about this one, but I know that it is a scary one. I think users would benefit from understanding GPG encryption.

grep awk sed etc.

More advanced but useful shell commands. This one would be very easy to write like shell.mdx.

shell scripting

A very breif guide on the basics of ZSH and SH scripting. Will save users hours if they learn it.

Package specific doccumentation stubs

The Arch and Gentoo wiki have docummentation/guides on specific packages. I would be very happy to write little guides on individual Linux commands.

dd

This can be added to the section that explains how to install Ultramarine Linux. I may also be added to the Disk Management section instead. Or the package specific docummentation. When I was a new user, I found this command very scary.

Vis

Vim/Vis is a very scary thing to new users. I would write a page on this. It would go under package specific doccummentation.

GNU Pass

Another package specific. This one in particular is very scary.

Recommended Reading

I was thinking that on each page, the community could recommend a book for the user to read to gain a more in depth knoledge of the topic.

Security

A page that explains cyber security basics. A topic that is very much relivent to using and learning Linux.

List of applications

I was also thinking that we could add a list of applications for different purposes. Users are always looking up "What is the best image veiwer for Linux," or something. This list would give them options. I have created a basic example of such a list. Each application would have a link and a discription as well.

Browsers

  • Floorp
  • Qutebrowser
  • Mothra
  • Lynx

Adblocking

Ublock Origin
/etc/hosts

Spreadsheet

Gnumeric
LibreOffice
Only Office
Awk

Text editors

VSCodium
Vis
Nvchad

Games

0A.D
Warmux
Supertux Kart
Supertux
Supertux2
Minetest
Freeciv
Veloren

Application launchers

Dmenu
Fuzzel
Rofi

Terminal Emulators

ST
Foot
Kitty
Budgie's default terminal

Image viewers

Gwenview
Imv
Feh
Ristretto

Volume control

pactl
pavucontrol

Caulculator

kcalc
lua
gforth

Unit conversion

Convertall

Media Player

mpv
VLC
Haruna
yt-dlp

File sharing clients

nicotine+
qbittorrent

Password managers

KeePassXC
GNU Pass

File Managers

Dolphin
Krusader
Pcmanfm
Rox filer
SFM
Ranger

Compilers

GCC
TCC
Clang/LLVM
Cproc/QBE

Conclusion

Anyways, those are the ideas that I came up with last night while I was heading to bed. I don't know the philisophy of the wiki, but if the community wants to expand it, here are ideas.

Difficulty reading low-contrast messages

Informational and warning messages have too low of a text/background contrast to be easily readable (see attached screenshot).

This could be just me, as my eyes are probably significantly older than those of your typical user base, but I suspect others with less than perfect vision might also encounter difficulties.

ultramarine_linux_20231003

[FEATURE REQUEST] Accessibility status/instructions in Wiki

Is your feature request related to a problem? Please describe.
Yes. Fedora (& by proxy Ultramarine) does not have a good guide for accessibility (including workarounds for Wayland).

Describe the solution you'd like
If inline with the goals of Ultramarine, I would like to contribute to this documentation, and ideally, for common concerns, work with Ultramarine developers to incorporate sane defaults for accessibility. With little effort we can highlight what works and what does not, and why.

Describe alternatives you've considered
N/A.

Additional context
Good examples of accessibility guides are the Accessibility section in the Ubuntu Desktop Guide and the Accessibility page in the Debian wiki.

Site looks weird without JS

Without JS, the sidebar is at the top, and main site content is below it. There is no margine to the left of the main content, and it looks weird. I have tested this in Netsurf.

Other than that, the site looks good. A possible fix would involve ensuring that the main content was to the right of the sidebar by using HTML/CSS.

If that doesn't work, then magin should be added to the left of the main content.

icon

where can i change favicon? when i replaced old one with new one, nothing changed

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.