i18n: update i18n files from po4a run
Some checks failed
ci / build_and_publish (push) Failing after 47s
Some checks failed
ci / build_and_publish (push) Failing after 47s
This commit is contained in:
parent
d6d8be1eca
commit
1c2899a9d2
70 changed files with 3238 additions and 879 deletions
|
|
@ -0,0 +1,160 @@
|
|||
---
|
||||
description: 'How to Create Your Own F-Droid Repo to Share as a Content Pack'
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# F-Droid Repo
|
||||
|
||||
You can build your own curated F-Droid repo using your computer's
|
||||
terminal. Once set up, users can connect their F-Droid app to your Butter
|
||||
Box and start downloading apps.
|
||||
|
||||
|
||||
|
||||
### Step 1: Install F-Droid Server Tools
|
||||
|
||||
Before you begin, you need to install a tool called **fdroidserver**. This
|
||||
helps you create and manage your app store.
|
||||
|
||||
**On Mac (using Homebrew):**
|
||||
|
||||
```
|
||||
brew install fdroidserver
|
||||
```
|
||||
|
||||
**On Linux (Debian/Ubuntu):**
|
||||
|
||||
```
|
||||
sudo apt install fdroidserver
|
||||
```
|
||||
|
||||
### Step 2: Check that it's installed correctly
|
||||
|
||||
After installation, run this command:
|
||||
|
||||
```
|
||||
fdroid version
|
||||
```
|
||||
|
||||
If everything is working, you will see a version number printed on the
|
||||
screen.
|
||||
|
||||
### Step 3: Create Your Repo Folder
|
||||
|
||||
You need to create the folder where you will save the repo files in your
|
||||
computer, choose a name that aligns with the project or purpose of the apps
|
||||
in it, and replace my-fdroid-repo for that name in the command.
|
||||
|
||||
```
|
||||
mkdir -p ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
```
|
||||
cd ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
### Step 4: Initialize the repo
|
||||
|
||||
```
|
||||
fdroid init
|
||||
```
|
||||
|
||||
This creates the following directories in your repo file:
|
||||
|
||||
```
|
||||
Config.yml
|
||||
```
|
||||
|
||||
```
|
||||
repo/
|
||||
```
|
||||
|
||||
```
|
||||
metadata/
|
||||
```
|
||||
|
||||
### Step 5: Add your APKs
|
||||
|
||||
Copy your signed APKs into the repo/ folder. Ensure you only use apps from
|
||||
trusted sources like the official F-Droid library or verified developers.
|
||||
|
||||
**Security Note:** Avoid downloading APKs from "mirror" sites or unknown sources, as they can contain malware or trackers that compromise your users' privacy.
|
||||
|
||||
```
|
||||
cp /path/to/your/*.apk repo/
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
cp ~/Downloads/myapp.apk repo/
|
||||
```
|
||||
|
||||
### Step 6: Generate (and Update) the Repository Index
|
||||
|
||||
Every time you add a new APK or a new version of an app to your repo/
|
||||
folder, you must run the following command to "publish" those changes:
|
||||
|
||||
```
|
||||
fdroid update --create-metadata
|
||||
```
|
||||
|
||||
What this command does:
|
||||
|
||||
* **Scans APKs:** It reads the new files in your repo/ folder.
|
||||
* **Generates Metadata:** It creates YAML files containing the app's name,
|
||||
version, and permissions.
|
||||
* **Creates index.v1.jar:** This is the "catalog" file that the F-Droid app
|
||||
downloads to see what is available.
|
||||
* **Signs the Repository:** It uses your secret key to sign the index,
|
||||
proving to the Android app that the files haven't been tampered with.
|
||||
|
||||
### Step 7: Test your Repo locally
|
||||
|
||||
To test your repo locally and ensure everything works before you share it on
|
||||
the Butter Box, you can serve its content locally and add it to F-Droid
|
||||
using a URL.
|
||||
|
||||
```
|
||||
cd repo
|
||||
```
|
||||
|
||||
```
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
Once your repo is live, open the F-Droid app on your device and navigate to **Settings > Repositories > "+"**. Select **"Enter repository URL manually"** to add your new source.
|
||||
|
||||
Adding the repo manually allows you to verify the user experience by
|
||||
checking:
|
||||
|
||||
* **App Visibility:** Are all your apps appearing in the list?
|
||||
* **Visual Assets:** Are icons and screenshots displaying correctly?
|
||||
* **Categorization:** Are apps appearing in the correct sections (e.g.,
|
||||
Internet, Security)?
|
||||
* **Functionality:** Do the downloads and installations complete without
|
||||
errors?
|
||||
* **Metadata:** Does the version number and description match your `repo/`
|
||||
files?
|
||||
|
||||
|
||||
|
||||
Your repo will be available at:
|
||||
|
||||
`http://YOUR-IP:8000/repo`
|
||||
|
||||
|
||||
|
||||
**Find your IP:**
|
||||
|
||||
#### macOS:
|
||||
|
||||
```
|
||||
ipconfig getifaddr en0
|
||||
```
|
||||
|
||||
#### Linux:
|
||||
|
||||
```
|
||||
hostname -I
|
||||
```
|
||||
|
|
@ -0,0 +1,50 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Apps
|
||||
|
||||
You can share apps as a content pack, via a static website. If you give a
|
||||
folder the name `appstore` and place it in the root directory of the USB
|
||||
drive, the **Apps** tile will appear in the Butter Box portal.
|
||||
|
||||
**Things To Know**
|
||||
|
||||
* If you are sharing apps from Butter Box, you will need to download the app
|
||||
files you want to share. Apps are updated frequently. Be sure to manually
|
||||
update all of the app files frequently to ensure you are providing the
|
||||
highest security for the people who connect to the box.
|
||||
* You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe
|
||||
and trusted source.
|
||||
* Butter won’t automatically verify the source, so it's up to you to
|
||||
confirm it's clean and legal to share.
|
||||
* How to get apk files: There are mobile apps you can use to get access to
|
||||
apk files on an Android phone. Alternatively, you can download app files
|
||||
directly from the developer's website.
|
||||
|
||||
### Go Further: Butter Box Supports Sharing Via F-Droid
|
||||
|
||||
Additionally, Butter Box supports app distribution via F-Droid. In your
|
||||
content pack, you can include the F-Droid `.apk` and a QR code for your
|
||||
repo. Anyone with access to the Box can then download the F-Droid app while
|
||||
offline, and add the repo.
|
||||
|
||||
As long as they are connected to the Butter Box, they can download any of
|
||||
the apps within your repo.
|
||||
|
||||
If they are connected to the internet later, they can receive app updates
|
||||
from any apps in your repo that are also included in the official F-Droid
|
||||
repo. If you update the apps in your repo, they will also have access to
|
||||
those.
|
||||
|
||||
What is a F-Ddroid Repo?
|
||||
|
||||
* A hosted library of apps\ Why use it?
|
||||
* It offers a secure process for sharing apps. The F-Droid team builds apps
|
||||
in the official F-Droid repo from the source code themselves. This ensures
|
||||
that the app you download exactly matches the code the developer
|
||||
published.
|
||||
* Users installing from F-Droid have access to app updates remotely (away
|
||||
from the Butter Box)
|
||||
|
||||
Technical skills are required to create your own F-Droid repo. Refer to the
|
||||
[F-Droid Repo](f-droid-repo) Section for instructions.
|
||||
|
|
@ -1,50 +1,74 @@
|
|||
---
|
||||
title: "Наборы контента"
|
||||
nav_order: 5
|
||||
has_children: true
|
||||
permalink: /content-packs/
|
||||
description: 'Curated pluggable content'
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Наборы контента
|
||||
|
||||
Вы можете создать свой собственный набор контента! Его просто нужно оформить как **статический сайт с локальными ссылками**. Этот сайт будет работать непосредственно с устройства, поэтому все изображения и файлы, необходимые для сайта, должны находиться в одной главной папке.
|
||||
Вы можете создать свой собственный набор контента! Его просто нужно оформить
|
||||
как **статический сайт с локальными ссылками**. Этот сайт будет работать
|
||||
непосредственно с устройства, поэтому все изображения и файлы, необходимые
|
||||
для сайта, должны находиться в одной главной папке.
|
||||
|
||||
Когда ваш статический сайт будет готов, поместите все необходимые файлы в одну папку и разместите эту папку в **корневой директории** вашего USB-накопителя. Этот сайт будет отображаться в браузере, через который пользователи получают доступ к порталу Butter Box.
|
||||
Когда ваш статический сайт будет готов, поместите все необходимые файлы в
|
||||
одну папку и разместите эту папку в **корневой директории** вашего
|
||||
USB-накопителя. Этот сайт будет отображаться в браузере, через который
|
||||
пользователи получают доступ к порталу Butter Box.
|
||||
|
||||
Советы по созданию набора контента со статическим сайтом:
|
||||
|
||||
* **Содержимое.** Всё для статического сайта должно храниться на USB-накопителе, подключённом к Butter Box. Сайт не должен ссылаться на ресурсы в глобальном интернете.
|
||||
* **Размер.** Размер вашего набора контента ограничен доступным пространством на USB-накопителе. При этом учитывайте, что если несколько человек одновременно скачивают или просматривают очень большие файлы с устройства, возможны задержки.
|
||||
* **Страницы.** Ссылки между страницами должны вести на другие сохранённые страницы в той же папке, а не в интернет. Необходимо использовать относительные пути (например, about/index.html) вместо абсолютных веб-URL.
|
||||
* **Медиа.** Изображения, видео и звуки не могут ссылаться на онлайн-ресурсы. Файлы должны находиться в папке вашего сайта и храниться на USB-накопителе.
|
||||
* **Библиотеки.** Сайт не может использовать JavaScript-библиотеки, которые зависят от интернет-соединения.
|
||||
* **Стили.** Специальные шрифты и иконки (например, из Google Fonts) также должны находиться в папке, а не загружаться из сети.
|
||||
* **Содержимое.** Всё для статического сайта должно храниться на
|
||||
USB-накопителе, подключённом к Butter Box. Сайт не должен ссылаться на
|
||||
ресурсы в глобальном интернете.
|
||||
* **Размер.** Размер вашего набора контента ограничен доступным
|
||||
пространством на USB-накопителе. При этом учитывайте, что если несколько
|
||||
человек одновременно скачивают или просматривают очень большие файлы с
|
||||
устройства, возможны задержки.
|
||||
* **Страницы.** Ссылки между страницами должны вести на другие сохранённые
|
||||
страницы в той же папке, а не в интернет. Необходимо использовать
|
||||
относительные пути (например, about/index.html) вместо абсолютных веб-URL.
|
||||
* **Медиа.** Изображения, видео и звуки не могут ссылаться на
|
||||
онлайн-ресурсы. Файлы должны находиться в папке вашего сайта и храниться
|
||||
на USB-накопителе.
|
||||
* **Библиотеки.** Сайт не может использовать JavaScript-библиотеки, которые
|
||||
зависят от интернет-соединения.
|
||||
* **Стили.** Специальные шрифты и иконки (например, из Google Fonts) также
|
||||
должны находиться в папке, а не загружаться из сети.
|
||||
|
||||
### Попробуйте
|
||||
|
||||
* Приведённый ниже zip-файл содержит пример статического сайта. Чтобы понять, как статические сайты работают с Butter — скачайте его. Распакуйте. Затем добавьте этот набор файлов на ваш USB-накопитель.
|
||||
* The zip file below contains a sample static website. To get a feel for how
|
||||
static websites work with butter—Download it. Unzip it. Then, add this set
|
||||
of files to your USB drive.
|
||||
|
||||
[Скачать файл](/img/docs/Sample%20Static%20Website.zip)
|
||||
|
||||
|
||||
You can also check out our [New Content Pack News](/docs/content-packs).
|
||||
|
||||
### Начните работу
|
||||
|
||||
Лучший способ начать создание собственного набора контента — это определиться с идеей о том, какой опыт и какую информацию вы хотите предоставить, а затем спроектировать и создать для этого локальный статический сайт.
|
||||
Лучший способ начать создание собственного набора контента — это
|
||||
определиться с идеей о том, какой опыт и какую информацию вы хотите
|
||||
предоставить, а затем спроектировать и создать для этого локальный
|
||||
статический сайт.
|
||||
|
||||
Это может быть что-то очень простое, например, аудиоплеер для музыки. Или
|
||||
список из пяти лучших VPN-приложений, которые вы рекомендуете. Или например
|
||||
библиотека, база знаний культурных артефактов.
|
||||
|
||||
|
||||
Это может быть что-то очень простое, например, аудиоплеер для музыки. Или список из пяти лучших VPN-приложений, которые вы рекомендуете. Или например библиотека, база знаний культурных артефактов.
|
||||
|
||||
### Добавьте файлы сайта на USB-накопитель
|
||||
|
||||
Поместите папку с файлами сайта в **корневую директорию** USB-накопителя. Убедитесь, что папка вашего сайта содержит файл **index.html.** Название этой папки будет отображаться на портале Butter Box.
|
||||
Поместите папку с файлами сайта в **корневую директорию**
|
||||
USB-накопителя. Убедитесь, что папка вашего сайта содержит файл
|
||||
**index.html.** Название этой папки будет отображаться на портале Butter
|
||||
Box.
|
||||
|
||||
<figure><img src="/assets/images/Screenshot 2025-08-16 at 9.46.16 PM.png" alt=""/><figcaption><p>Директория USB при просмотре в Finder на компьютере</p></figcaption></figure>
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Подключитесь к Butter Box для просмотра
|
||||
|
||||
Вставьте USB-накопитель в Butter Box. Когда вы откроете портал Butter Box, нажмите **Файлы**. Перейдите в папку сайта. Нажмите для просмотра.
|
||||
|
||||
Вставьте USB-накопитель в Butter Box. Когда вы откроете портал Butter Box,
|
||||
нажмите **Файлы**. Перейдите в папку сайта. Нажмите для просмотра.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,38 +1,41 @@
|
|||
---
|
||||
title: "Карты"
|
||||
nav_order: 1
|
||||
parent: "Наборы контента"
|
||||
sidebar_position: 2
|
||||
---
|
||||
# Maps
|
||||
|
||||
# Карты
|
||||
You can make offline maps available from your Butter Box. These maps are
|
||||
powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
||||
|
||||
Вы можете сделать офлайн-карты доступными через ваш Butter Box. Эти карты работают на основе **OpenStreetMap (OSM)** и приложения **OsmAnd** для Android.
|
||||
:::warning
|
||||
**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.
|
||||
:::
|
||||
|
||||
> **Внимание:**
|
||||
> **Важно:** Загрузка офлайн-карт работает **только на устройствах Android**. iOS не поддерживается.
|
||||
### ✅ Steps to Enable Maps
|
||||
|
||||
### ✅ Шаги для включения офлайн-карт
|
||||
**1. Download the map files you need**
|
||||
|
||||
**1. Скачайте приложение OsmAnd (APK для Android)**
|
||||
* Visit: [OsmAnd Local Indexes
|
||||
List](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Choose and download the regions you want available offline.
|
||||
|
||||
* Перейдите по ссылке: [Бесплатные версии OsmAnd — Android](https://osmand.net/docs/versions/free-versions)
|
||||
* Скачайте последний APK-файл.
|
||||
**2. Organize your files**
|
||||
|
||||
**2. Скачайте нужные файлы карт**
|
||||
* On your USB drive, create a folder named `osm-map-files` .
|
||||
* Put the **OsmAnd APK** and all your **map files** into this folder.
|
||||
|
||||
* Перейдите по ссылке: [Список локальных индексов OsmAnd](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Выберите и скачайте регионы, которые хотите использовать офлайн.
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
**3. Организуйте файлы**
|
||||
**3. Add to your Butter Box**
|
||||
|
||||
* На USB-накопителе создайте папку с именем `osm-map-files` .
|
||||
* Поместите **APK-файл OsmAnd** и все ваши **файлы карт** в эту папку.
|
||||
* Insert the USB drive into your Butter Box.
|
||||
* The **Offline Maps** tile will automatically appear in your Butter Box
|
||||
portal.
|
||||
|
||||
|
||||
👉 That’s it — anyone using an **Android device** can now download OsmAnd and
|
||||
the offline maps you’ve provided directly from your Butter Box.
|
||||
|
||||
**4. Добавьте на Butter Box**
|
||||
|
||||
* Вставьте USB-накопитель в Butter Box.
|
||||
* Иконка **Офлайн-карты** автоматически появится на портале Butter Box.
|
||||
|
||||
👉 Вот и всё — теперь любой пользователь с **устройством Android** может скачать OsmAnd и офлайн-карты, которые вы предоставили, прямо с вашего Butter Box.
|
||||
Note: The OSM map apk is available on the Butter Box software image. Updates
|
||||
to the OsmAnd app will be available with new releases of the Butter Box
|
||||
software. If you want to know what the latest available version of OsmAnd
|
||||
app is, visit [OsmAnd Free Releases —
|
||||
Android](https://osmand.net/docs/versions/free-versions).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue