Mirrors/tachiyomi-website
2
0
Fork 0
mirror of https://github.com/tachiyomiorg/website.git synced 2024-10-31 23:15:05 +01:00
Code Issues Packages Projects Releases Wiki Activity
d5285cc0a7
tachiyomi-website/CONTRIBUTING.md
Soitora d5285cc0a7
Upgrade to Vitepress 1.0.0-beta.7 
Also uses their out-of-box `pageClass`.

Also removes our Sitemap in favor of theirs, although this was not working for me so it's commented out for now.

Also makes `npm run build` normal again, please use `npm run test` for full pre-PR testing.
2023-07-30 03:12:47 +02:00

2.5 KiB
Raw Blame History

Tachiyomi Website Contributing Guide

Before submitting your contribution, please make sure to take a moment and read through the following guidelines:

Development Setup

You will need Node.js version 16+, and npm version 8+.

After cloning the repo and entering the the directory, go to the /website folder and run:

# Installs any dependencies needed.
$ npm install

To run the project now, run:

# This command start a local server you can access and edit live.
$ npm run dev

Commonly used NPM scripts

# This command will generate a static site inside a dist directory in your project.
$ npm run build

# Run this command to preview the built files in a local server.
$ npm run preview

Please make sure to have npm run test pass successfully before submitting a PR. Although the same tests will be run against your PR on the CI server, it is better to have it working locally.

It is also recommended you lint your files before the PR.

Project Structure

  • website: contains all the website related files.
    • src: contains all the markdown files used for the website.
      • .vitepress:
        • dist: contains built files for distribution. Note this directory is only updated when a release happens or when you run the build command. Changes to this folder will not carry over with Git.
        • theme: contains custom theme files.
        • config.ts: main configuration file for VitePress.
      • public: files to be exposed publicly without any processing.
    • package.json: contains information about which plugins are installed in the project.

Images and Videos guidelines

Common

  • Use the Android Emulator

  • Use the default white theme

  • Preferably use local source or a self-hosted extension if your media contains manga

  • Resize to have a width of 648px

Images

  • Use .webp

Videos

Credits

Thank you to all the people who have already contributed!

List of Contributors