diff options
-rw-r--r-- | docs/administration/CLI_tasks/frontend.md | 28 | ||||
-rw-r--r-- | lib/mix/tasks/pleroma/frontend.ex | 28 |
2 files changed, 23 insertions, 33 deletions
diff --git a/docs/administration/CLI_tasks/frontend.md b/docs/administration/CLI_tasks/frontend.md index 6c31bd660..b66ac14d3 100644 --- a/docs/administration/CLI_tasks/frontend.md +++ b/docs/administration/CLI_tasks/frontend.md @@ -1,9 +1,27 @@ # Managing frontends -`mix pleroma.frontend install kenoma --ref=stable` +`mix pleroma.frontend install <frontend> --path <path>` -`develop` and `stable` refs are special: they are not necessarily `develop` or -`stable` branches of the chosen frontend repo, but are smart aliases for either -default branch of a frontend repo (develop), or latest release in a repo (stable). -Only refs that have been built with Gitlab CI can be installed
\ No newline at end of file +Install locally built frontend. + +Currently supported `<frontend>` values: +- [admin](https://git.pleroma.social/pleroma/admin-fe) +- [kenoma](http://git.pleroma.social/lambadalambda/kenoma) +- [mastodon](http://git.pleroma.social/pleroma/mastofe) +- [pleroma](http://git.pleroma.social/pleroma/pleroma-fe) + +The complete process of installing frontend would be following: +- download a frontend: + +```bash +git clone https://git.pleroma.social/pleroma/pleroma-fe.git +``` +- build the frontend +```bash +cd pleroma-fe && yarn && yarn build +``` +- run the following command inside your Pleroma instance root directory: +```bash +mix pleroma.frontend install pleroma --path /path/to/pleroma-fe +```
\ No newline at end of file diff --git a/lib/mix/tasks/pleroma/frontend.ex b/lib/mix/tasks/pleroma/frontend.ex index 2f4bdf1b4..372928323 100644 --- a/lib/mix/tasks/pleroma/frontend.ex +++ b/lib/mix/tasks/pleroma/frontend.ex @@ -3,38 +3,10 @@ # SPDX-License-Identifier: AGPL-3.0-only defmodule Mix.Tasks.Pleroma.Frontend do - @doc """ - Scenario 1: - - clone repo to /frontends/fe/_src_tmp - - build fe - - move built files into /frontends/fe - - remove frontends/fe/_src_tmp - - Scenario 2: - - download bundle from CI to /frontends/fe/_src_tmp - - move build files - - remove tmp - - Scenario 3: - - move built files from _path to /frontends/fe - - Pleroma: - /dist - Kenoma: - /build - Fedi: - /dist - Admin: - /dist - Mastodon - /public - """ use Mix.Task import Mix.Pleroma - # alias Pleroma.Config - @shortdoc "Manages bundled Pleroma frontends" @moduledoc File.read!("docs/administration/CLI_tasks/frontend.md") |