akkoma-fe/README.md

58 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

# Akkoma-FE
2016-10-26 14:46:32 +00:00
2022-08-23 15:12:06 +00:00
![English OK](https://img.shields.io/badge/English-OK-blueviolet) ![日本語OK](https://img.shields.io/badge/%E6%97%A5%E6%9C%AC%E8%AA%9E-OK-blueviolet)
2022-12-29 15:22:06 +00:00
This is a fork of Akkoma-FE from the Pleroma project, with support for new Akkoma features such as:
- MFM support via [marked-mfm](https://akkoma.dev/sfr/marked-mfm)
- Custom emoji reactions
2017-02-18 16:49:34 +00:00
2017-11-07 14:42:34 +00:00
# For Translators
The [Weblate UI](https://translate.akkoma.dev/projects/akkoma/pleroma-fe/) is recommended for adding or modifying translations for Akkoma-FE.
2022-07-28 23:59:53 +00:00
Alternatively, edit/create `src/i18n/$LANGUAGE_CODE.json` (where `$LANGUAGE_CODE` is the [ISO 639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) for your language), then add your language to [src/i18n/messages.js](https://akkoma.dev/AkkomaGang/pleroma-fe/src/branch/develop/src/i18n/messages.js) if it doesn't already exist there.
2022-12-29 15:22:06 +00:00
Akkoma-FE will set your language by your browser locale, but you can temporarily force it in the code by changing the locale in main.js.
2017-11-07 14:42:34 +00:00
2017-01-19 16:51:27 +00:00
# FOR ADMINS
2022-12-29 15:22:06 +00:00
To use Akkoma-FE in Akkoma, use the [frontend](https://docs.akkoma.dev/stable/administration/CLI_tasks/frontend/) CLI task to install Akkoma-FE, then modify your configuration as described in the [Frontend Management](https://docs.akkoma.dev/stable/configuration/frontend_management/) doc.
2017-01-19 16:51:27 +00:00
2016-10-26 14:46:32 +00:00
## Build Setup
Make sure you have [Node.js](https://nodejs.org/) installed. You can check `/.woodpecker.yml` for which node version the Akkoma CI currently uses.
2016-10-26 14:46:32 +00:00
``` bash
# install dependencies
2023-09-24 00:33:46 +00:00
corepack enable
2017-02-19 21:15:42 +00:00
yarn
2016-10-26 14:46:32 +00:00
# serve with hot reload at localhost:8080
npm run dev
# build for production with minification
npm run build
# run unit tests
npm run unit
```
# For Contributors:
You can create file `/config/local.json` (see [example](https://akkoma.dev/AkkomaGang/akkoma-fe/src/branch/develop/config/local.example.json)) to enable some convenience dev options:
* `target`: makes local dev server redirect to some existing instance's BE instead of local BE, useful for testing things in near-production environment and searching for real-life use-cases.
* `staticConfigPreference`: makes FE's `/static/config.json` take preference of BE-served `/api/statusnet/config.json`. Only works in dev mode.
FE Build process also leaves current commit hash in global variable `___pleromafe_commit_hash` so that you can easily see which pleroma-fe commit instance is running, also helps pinpointing which commit was used when FE was bundled into BE.
# Configuration
2019-03-30 10:42:42 +00:00
Edit config.json for configuration.
2018-11-07 15:56:12 +00:00
## Options
### Login methods
```loginMethod``` can be set to either ```password``` (the default) or ```token```, which will use the full oauth redirection flow, which is useful for SSO situations.