Documentation for Jellyfin
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Niels van Velzen c25ff6daee
Merge pull request #708 from psiberfunk/patch-1
2 weeks ago
.github Update fork check in publish workflow 3 months ago
.vscode Added VSC lint on save (#519) 2 years ago
general Update index.md 2 weeks ago
images More detailed documentation on recording post-processing 8 months ago
plugin-api style improvements and client status updates 3 years ago
src Update submodule to latest 3 years ago
.editorconfig fix some spelling mistakes (#251) 3 years ago
.gitignore Update gitignore 2 years ago
.gitmodules Put submodule always at the master branch. 3 years ago
.markdownlint.yml Do not allow bare URLs 3 years ago
LICENSE Add the CC-BY-SA-4.0 license 2 years ago
README.md Fix remaining issues 3 years ago
docfx.json initial work to remove release step as a requirement 2 years ago
index.md Remove forum badge 9 months ago
toc.yml Add API Documentation in main header 2 years ago

README.md

Jellyfin Documentation

Part of the Jellyfin Project

This repository houses all documentation for Jellyfin available at jellyfin.org and written in markdown.

Getting Started

The site is built with DocFX using DocFX Flavored Markdown. See the content section here for a quick tutorial on DocFX.

Since the site is mostly written with simple Markdown files, the easiest and fastest way to contribute is to just edit the source files directory on GitHub. For example, you could edit this README page by going to its edit page on GitHub.

Editing directly on GitHub provides a feature to preview your changes for the current document, but if you want to see your changes within the context of the actual website or make more advanced changes to the site, you will need to run a copy of the site locally.

To run the site locally, you will first need to clone this repository using git.

git clone https://github.com/jellyfin/jellyfin-docs.git

Next, you will need to install DocFx as a command line tool. Once installed, you can run the following command from the root directory of your cloned repository.

docfx --serve

This will build the site and start up a development server to test out your changes available at http://localhost:8080.

Linting

This repository is configured to use markdownlint for linting Markdown files.

If you are editing files within Visual Studio Code, you can install the markdownlint extension to see the linting errors as you work.

You can also easily run the linter manually using the associated markdownlint CLI.

npm install -g markdownlint-cli
markdownlint **/*.md --ignore node_modules --ignore src

Layout

The following sections explain the documentation content available for each area of the site.

Plugin API

Describe all available API surfaces and class from plugin development.

ApiSpec

apispec is used to overwrite specific plugin API page contexts.

Docs

docs is the main custom documentation directory. All uids for the custom documentation are relative to this directory, with administration and contributing shortened to admin and contrib respectively. So for example to reference the file general/administration/installing.md one would use xref:admin-installing with an optional anchor like xref:admin-installing#arch.

Administration

Should be used for documentation related to server setup including non-default configs for more advanced users.

Contributing

Should be used for documentation related to development, translations, releases, and other ways to contribute to the project.

Clients

Any documentation related to the clients.

Server

Any documentation related to managing the server or explaining certain features.

Media

Naming conventions for all supported media types, such as movies or podcasts.

Plugin

Any plugin documentation.