Mirrors/tachiyomi-website
2
0
Fork 0
mirror of https://github.com/tachiyomiorg/website.git synced 2024-11-01 07:25:06 +01:00
Code Issues Packages Projects Releases Wiki Activity
f25f2f3f99
tachiyomi-website/CONTRIBUTING.md
Soitora 4e09b24649 New contributor guides (#588) 
* Add Code of Conduct

* Add Contributing

* Tweak README

Adds the Contributing guide, Code of Conduct, removes border from repo images and adds credits.

* Update CONTRIBUTING.md

Co-authored-by: arkon <arkon@users.noreply.github.com>

* Contact point change

Co-authored-by: arkon <arkon@users.noreply.github.com>
2021-03-18 01:45:32 +01:00

3.1 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 12+, and npm version 7+.

After cloning the repo, 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 serve

Commonly used NPM scripts

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

# This command will lint your files.
$ npm run lint

Please make sure to have npm run build 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.

Project Structure

  • public: 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.

  • src: contains the main code files.

    • .vuepress: contains the main code files.

      • components: this contains all the .vue components used on the website.

      • config: contains complementary files for config.js.

        • navBar.js: config for navigation bar.

        • plugins.js: config for plugins.

        • sideBar.js: config for sidebar.

      • public: contains the static images/videos/scripts you'll want to use for the website.

      • store: this contains the data store file used to connect features like downloads to main app and its forks.

      • styles: all the projects style files are contained here.

      • theme: this contains the extended Vuepress theme files.

      • config.js: main config file for Vuepress.

      • constants.js: all reused variables/constants is stored here.

      • enhanceApp.js: this file is the place to install Vue plugins, register components and directives, etc.

    • download: contains the markdown file for the /download/ page.

    • extensions: contains the markdown file for the /extensions/ page.

    • forks: contains the markdown files for the /forks/... pages.

    • help: contains the markdown files for all the /help/... pages.

    • sandbox: contains the markdown files for the /sandbox/... pages.

    • README.md: markdown file for the front-page.

  • package.json: contains information about which plugins are installed in the project.

Credits

Thank you to all the people who have already contributed!