Rocky Linux Documentation

repository·main·Indexed 19 days ago

https://github.com/rocky-linux/documentation

Source files and contribution guidelines for Rocky Linux documentation, including Guides, Books, Labs, and Gemstones. This repository provides instructions for generating books using mkdocs and build_all.sh, submitting updates via GitHub, and managing translations through Crowdin.

Tokens
181K
Snippets
664
Records
835
Agent score
62%

What's inside Rocky Linux Documentation

  1. Overview of local documentation testing with MkDocs and Python venv

    main

    To ensure new documentation renders correctly before publication, developers can preview it in a local environment. Rocky Linux documentation is written in Markdown and converted to HTML using MkDocs, a Python-based static site generator.

    To avoid conflicts between documentation dependencies and the host system's Python modules, this guide recommends using the Python venv module (available in Python 3.6+) to create an isolated environment. This method provides isolation without requiring complex containerization systems.

  2. What is Rocksmarker?

    main

    Rocksmarker is an experimental Neovim configuration designed as a specialized IDE for Markdown-based documentation. It is built for technical writers and developers to create structured content, code documentation, and tutorials in a unified environment.

    Key features include:

    • Real-time Markdown rendering: Visualizing headings, code blocks, and lists directly in the editor.
    • LSP-powered intelligence: Robust syntax validation, style enforcement, and code linting.
    • Modular plugin management: Uses rocks.nvim for declarative, Lua-driven dependency management via Luarocks.
    • Unified workflow: Integrates writing, coding, and formatting into a single interface to eliminate tool switching.
  3. Overview of NvChad and Neovim IDE setup

    main

    NvChad is a configuration framework for Neovim designed to transform it from a basic text editor into a fully functional Integrated Development Environment (IDE). It uses Lua for configuration and employs Lazy loading techniques to ensure high performance and fast startup times.

    Key features include:

    • Speed: Optimized through Lua and lazy loading.
    • Modern UI: A clean, attractive command-line interface.
    • Extensibility: Designed as a base for users to build their own IDE via plugins.
    • Automatic Updates: Uses Git to allow quick updates via the :NvChadUpdate command.
    • Theming: Includes numerous built-in themes, switchable using the <leader> + th key combination.
  4. Manage software with DNF (Dandified Yum)

    main

    DNF is the default package manager for Rocky Linux. It manages RPM packages by comparing installed software against defined repositories and automatically resolving dependencies. It is the successor to YUM and is functionally similar for most common commands.

    Common tasks include installing, removing, searching, and inspecting packages using the dnf command.

    dnf [install|remove|list|search|info] package_name
  5. What is System.map and why is it used?

    main

    The System.map file is a lookup table that maps kernel symbol names to their corresponding hexadecimal addresses.

    Use Case: When the kernel encounters a critical error (often called an "Oops", similar to a Windows BSOD), it generates error messages containing hexadecimal numbers. System.map allows the system (and developers) to translate these hex addresses into human-readable function names, which is essential for debugging kernel bugs or hardware issues.

  6. What is EPEL and its support considerations

    main

    EPEL (Extra Packages for Enterprise Linux) is a free, community-managed repository that provides software packages from Fedora sources for RHEL-based distributions like Rocky Linux.

    Important Support Note: EPEL packages do not receive official support from RHEL. While they are widely used, their availability is tied to the Fedora development lifecycle; there is a remote possibility that packages could disappear if they are not maintained as Fedora evolves.

  7. What is systemd and its core purposes

    main

    Overview

    systemd (system daemon) is an init software suite for GNU/Linux operating systems. It serves as the primary initialization system, replacing traditional SysV-style init programs.

    Core Purposes

    • Dependency Management: Provides a framework for representing and managing dependencies between services.
    • Parallel Startup: Implements parallel startup of services during system initialization to reduce boot times.
    • Reduced Overhead: Reduces shell overhead compared to legacy SysV init systems.
    • Unified Configuration: Unifies service configuration and behavior across different GNU/Linux distributions.

    Key Features

    • PID 1: Runs as the first process (PID 1) to manage the startup and shutdown sequences.
    • Service Management: Provides the systemctl utility for user interface interaction.
    • Socket & D-Bus Activation: Uses sockets and D-Bus to start services on-demand or react to device changes (plug-and-play).
    • Timer Support: Provides systemd timers, which function similarly to cron scheduled tasks.
    • Logging: Manages system and service logs.
    • System Configuration: Manages basic components like hostname, time/date, locale, and logs.
    • Filesystem Management: Handles mounting/unmounting file systems in layers for secure cascading.
    • Boot Analysis: Includes tools to analyze the startup sequence and identify services causing delays.
  8. Overview of the RPM package management system

    main

    RPM (Red Hat Package Manager) is the software management system used by Rocky Linux and other Red Hat-based distributions (such as Fedora and CentOS). It is used to install, uninstall, update, or query software.

    Key distinctions in terminology:

    • RPM (capitalized): Refers to the package management system.
    • rpm (lowercase): Refers specifically to the rpm command-line tool.
    • .rpm: Refers to the file format suffix used for the packages themselves.
  9. What is NFS and how does it work?

    main

    NFS (Network File System) allows sharing files and directories across a network between Linux systems (and Windows systems with appropriate software).

    NFS operates on a client-server model:

    • Server side: The system that exports (shares) the file systems.
    • Client side: The systems that access the exported file systems.

    NFSv4 requires the following daemons to function:

    • portmap: Maps RPC programs to standard network ports.
    • mountd: Manages incoming mount requests.
    • nfsd: The primary NFS program that handles actual file transfers.