feat: refactor to remove www

resolves #4
This commit is contained in:
Chris Milne 2026-04-24 12:47:12 +01:00
parent 2d84b9056a
commit a1cca9205f
322 changed files with 1 additions and 30 deletions

View file

@ -0,0 +1,30 @@
{
"version.label": {
"message": "Next",
"description": "The label for version current"
},
"sidebar.tutorialSidebar.category.Build A Box": {
"message": "Build A Box",
"description": "The label for category 'Build A Box' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Raspberry Pi": {
"message": "Raspberry Pi",
"description": "The label for category 'Raspberry Pi' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Services": {
"message": "Services",
"description": "The label for category 'Services' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Content Packs": {
"message": "Content Packs",
"description": "The label for category 'Content Packs' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.Apps": {
"message": "Apps",
"description": "The label for category 'Apps' in sidebar 'tutorialSidebar'"
},
"sidebar.tutorialSidebar.category.FAQ": {
"message": "FAQ",
"description": "The label for category 'FAQ' in sidebar 'tutorialSidebar'"
}
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.6 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.7 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.7 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 375 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.4 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 374 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 374 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 371 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 358 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 488 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 491 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 491 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 420 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 26 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 101 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 776 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 853 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 286 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 286 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 286 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 263 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 259 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 264 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 251 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 251 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 132 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 383 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 406 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 421 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 388 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 388 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 495 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 494 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 546 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 438 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 352 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 18 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 398 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 56 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 86 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 111 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 103 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 152 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 136 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 116 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 105 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 386 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 641 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 173 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 641 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 299 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 59 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 320 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 183 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 87 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 143 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 73 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 81 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 133 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1 MiB

View file

@ -0,0 +1,24 @@
---
title: "Сборка Butter Box"
nav_order: 3
has_children: true
permalink: /build-a-box/
---
# Сборка Butter Box
Ещё нет Butter Box? Вы можете легко собрать своё устройство. Выберите конфигурацию, чтобы начать.
## Конфигурации Butter Box
Программное обеспечение Butter Box в настоящее время работает на устройствах Raspberry Pi: Pi Zero 2 и Pi 4. Вы можете использовать любое из них. Подробности в сравнительной таблице ниже.
| Устройство | Ёмкость | Комплектующие |
| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------- |
| <strong>Базовая</strong> Raspberry Pi Zero Pi 2<br/><br/><a href="raspberry-pi/basic-box-supplies.mdx">Начать</a> | До 10 человек, на расстоянии около 10 метров | [Список комплектующих](raspberry-pi/basic-box-supplies.mdx) |
| <strong>Расширенная</strong> Raspberry Pi 4 в связке с роутером<br/><br/><a href="raspberry-pi/extend-your-box.mdx">Начать</a> | До 20 человек, на расстоянии около 30 метров при использовании с роутером | [Список комплектующих](raspberry-pi/extend-your-box.mdx) |
| ПК/Ноутбук (amd64) | _Скоро будет_ | _Скоро будет_ |
Мы также изготавливаем и отправляем Butter Box партнёрам по всему миру.
Если вы работаете с сообществом, которому это может быть полезно, мы будем рады сотрудничеству.

View file

@ -0,0 +1,8 @@
---
title: "ПК/Ноутбук"
nav_order: 2
parent: "Сборка Butter Box"
---
# ПК/Ноутбук

View file

@ -0,0 +1,19 @@
---
title: "Источник питания"
nav_order: 3
parent: "Сборка Butter Box"
---
# Источник питания
Если вы хотите, чтобы Butter Box работал полностью автономно и без электричества — это возможно!
Butter Box может работать от розетки, от предварительно заряженного аккумулятора или от аккумулятора с солнечной панелью.
* **Розетка:** Официальный и рекомендуемый блок питания для компьютеров Raspberry Pi (зависит от используемой модели Raspberry Pi)
* **Предварительно заряженный аккумулятор (Power Bank):** Это наиболее распространённый вариант для использования в полевых условиях.
* Портативное зарядное устройство Anker [power bank](https://www.ozon.ru/product/zaryadnoe-ustroystvo-anker-nano-charger-45w-chernyy-a2692l11-3298658513/),
[power bank](https://aliexpress.ru/item/1005011864808436.html)
* **Солнечная панель (с Power Bank):** Используйте небольшую солнечную панель для подзарядки вашего power bank. Это хороший вариант для непрерывной работы устройства в местах без электросети. Использование солнечной панели напрямую без аккумулятора возможно, но нестабильно при переменной облачности.
* Комплекты солнечных панелей: [ozon.ru](https://www.ozon.ru/search/?text=%D0%A1%D0%BE%D0%BB%D0%BD%D0%B5%D1%87%D0%BD%D0%B0%D1%8F+%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C+%D1%81%D0%BA%D0%BB%D0%B0%D0%B4%D0%BD%D0%B0%D1%8F&from_global=true)
<figure><img src="../.gitbook/assets/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>

View file

@ -0,0 +1,36 @@
---
title: "Основные комплектующие"
nav_order: 1
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Основные комплектующие
Базовая конфигурация Butter Box — это Raspberry Pi Zero 2 W с картой microSD, на которой установлено программное обеспечение Butter, USB-накопитель и питание от USB-источника, такого как блок питания, power bank или солнечная панель.
В большинстве таких конфигураций Butter Box может комфортно обслуживать **от 4 до 10 подключённых устройств одновременно** без замедления. Возможно подключить и больше, но производительность может снизиться, если все одновременно загружают большие файлы или видео.
Радиус действия составляет около **510 метров** в помещении, в зависимости от модели Raspberry Pi, а также от стен и помех. На открытом воздухе, на открытом пространстве, он иногда может быть больше. Представьте себе радиус действия домашнего Wi-Fi роутера — достаточно, чтобы покрыть класс, кафе, переговорную комнату или небольшое мероприятие на открытом воздухе.
## Комплектующие
* [ ] Raspberry Pi Zero 2W (64 Bit) [ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865](https://ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865); Или вы можете купить комплект здесь: [ozon.ru/product/kompyuter-v-sborke-2136359684](https://ozon.ru/product/kompyuter-v-sborke-2136359684)
* [ ] Блок питания с кабелем, входящие в комплект Raspberry Pi Zero 2W, или [альтернативный источник питания](../power-supply.mdx)
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди загружают в чат, сохраняются на карте; они никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (по необходимости)
* [ ] Micro USB/штекер на USB A/гнездо
* [ ] Переходник для подключения карты micro SD к вашему ноутбуку (если необходимо)
**Когда у вас будут все комплектующие, переходите к разделу «Установка Butter».**
[install-butter.md](install-butter.mdx)
![](../../assets/images/20250815_142828.jpg)

View file

@ -0,0 +1,64 @@
---
title: "Апгрейд Butter Box"
nav_order: 3
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Апгрейд Butter Box
Butter Box с увеличенным радиусом действия объединяет Raspberry Pi с отдельным Wi-Fi маршрутизатором, обеспечивая более сильный сигнал и большее количество одновременных подключений.
С маршрутизатором сеть может охватывать 10-30 м и комфортно поддерживать 1020 подключённых устройств одновременно. Эта конфигурация идеально подходит для средней группы людей в помещении среднего размера, например, в учебных классах, на мероприятиях или в общественных пространствах.
## Необходимые материалы
* [ ] Raspberry Pi 4, 5 или Raspberry Pi Zero 2W
* [ ] Маршрутизатор ([Opal (GL-SFT1200) Wireless Travel Router](https://store-us.gl-inet.com/products/united-states-opal-gl-sft1200-gigabit-wireless-router-dual-band-openwrt-ipv6-tor) или аналог)
* [ ] Блок питания и кабели питания для Raspberry Pi и маршрутизатора или [альтернативный источник питания](../power-supply.mdx)
* [ ] Карта Micro SD: образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем Micro SD карту 256 ГБ). Медиафайлы, которые пользователи загружают в чат, сохраняются на карте и никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (при необходимости)
одключение к интернету не требуется._
![](../../assets/images/20250815_142438.jpg)
## Шаги
Чтобы увиличить радиус действия вашего Butter Box, просто подключите маршрутизатор GLi-Net к Butter Box с помощью кабеля Ethernet. Вместо доступа к коробке через портальную точку доступа Wi-Fi (например, butter box или любое имя, которое вы задали в настройках администратора), пользователи будут подключаться к сети Wi-Fi маршрутизатора.
### Подключите Butter Box к источнику питания.
Подключите Butter Box к питанию.
---
### Подключите маршрутизатор
Подключите маршрутизатор к питанию. Затем используйте кабель Ethernet для подключения к Butter Box. Убедитесь, что кабель Ethernet подключён к порту LAN на вашем маршрутизаторе.
---
### Проверьте подключение
Подключитесь к Wi-Fi маршрутизатора. Если вы ещё не настраивали и не использовали этот маршрутизатор, введите пароль по умолчанию, указанный в руководстве пользователя, входящем в комплект. Через 30 секунд откройте http://butterbox.local в браузере.
---
### Отключите точку доступа Wi-Fi Butter Box
Откройте настройки администратора на портале Butter Box. Перейдите в раздел **Безопасный портал**. Отключите точку доступа Wi-Fi. Это скроет сеть Wi-Fi, транслируемую Raspberry Pi, чтобы пользователи не путались, к какой сети подключаться.
---
### Пригласите пользователей подключиться к Wi-Fi маршрутизатора
Теперь пользователи будут подключаться к сети Wi-Fi маршрутизатора, когда захотят подключиться к Butter Box.

View file

@ -0,0 +1,10 @@
---
title: "Raspberry Pi"
nav_order: 1
parent: "Сборка Butter Box"
has_children: true
permalink: /build-a-box/raspberry-pi/
---
# Raspberry Pi

View file

@ -0,0 +1,112 @@
---
title: "Установка Butter"
nav_order: 2
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# Установка Butter
Вам понадобится:
* Настольный компьютер
* Подключение к интернету
* Butter Box
### Скачайте Butter OS для Raspberry Pi
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)
> **Информация:**
> Всегда выбирайте последнюю версию файла.
---
### Вставьте карту micro SD в компьютер
Чтобы вставить карту micro SD в компьютер, вам может понадобиться адаптер:
![Пример адаптера (USB-C к Micro SD)](../../assets/images/image.png)
> **Информация:**
> Подключать коробку к компьютеру не нужно.
---
### Запустите Raspberry Pi Imager
После того как вы вставили карту micro SD в компьютер с подключением к интернету, запустите Raspberry Pi Imager на настольном компьютере. Программа проведёт вас через шаги установки операционной системы Butter на карту micro SD.
Если у вас нет Raspberry Pi Imager, вы можете скачать его здесь: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
---
### Выберите устройство > **Raspberry Pi Zero 2 W**
После запуска Raspberry Pi Imager вам будет предложено выбрать устройство Raspberry Pi.
<img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.56.27AM.png" alt=""/>
<p>Выберите Raspberry Pi Zero 2 W (или другое устройство, если у вас не стандартная коробка от Butter HQ)</p>
---
### Выберите операционную систему > Use Custom
* На вкладке ОС выберите **Use Custom** и загрузите файл butter-******.img Убедитесь, что вы **распаковали файл xz** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.57.31AM.png" alt=""/><figcaption><p>Выберите «Use Custom». Выберите файл .img, который скачали с Dropbox.</p></figcaption></figure>
---
### Выберите хранилище > Выберите карту Micro SD
* На вкладке **Хранилище** выберите **карту Micro SD.**
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.37PM.png" alt=""/><figcaption><p>Выберите карту Micro SD.</p></figcaption></figure>
После того как вы всё выбрали, ваш экран будет выглядеть примерно так:
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.43PM.png" alt=""/><figcaption><p>Финальный экран после выбора.</p></figcaption></figure>
Вам может быть показано сообщение _«Doing this will erase all data from selected external storage»_ и _«do you want to apply settings?»_, нажмите _«no, clear settings»_.
После этого выберите _«write»_ и начните процесс записи на карту Micro SD.
---
### Извлеките из компьютера и вставьте карту Micro SD в Raspberry Pi (Butter Box)
По завершении извлеките карту Micro SD. Вставьте карту Micro SD в Raspberry Pi (Butter Box), который не подключён к питанию.
---
### Перейдите к быстрому старту
Подключите Raspberry Pi (Butter Box) к питанию. Подождите несколько мгновений и подключитесь к порталу Butter Box. Перейдите в раздел [Быстрый старт](../../quick-start.mdx) для получения дополнительной информации.
---
**Если вы собираете улучшенный Butter Box (с увеличенным радиусом действия), перейдите к следующему разделу: Апгрейд Butter Box.**
[extend-your-box.md](extend-your-box.mdx)
### Устранение неполадок
Если вы видите ошибку, указывающую, что входной файл не является допустимым образом диска, проверьте скачанный файл.
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
Также убедитесь, что вы **распаковали файл** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.28.37PM.png" alt=""/><figcaption></figcaption></figure>

View file

@ -0,0 +1,20 @@
---
title: "Примеры использования"
nav_order: 9
---
# Примеры использования
### 1. Тренинги по цифровой безопасности для распространения приложений и материалов
> Лидеры из стран Южной Африки путешествуют для проведения тренингов, аудитов и консультаций для организаций по вопросам цифровой безопасности, физической безопасности, оценки рисков, а также для оснащения журналистов, активистов и правозащитников инструментами и знаниями для более безопасного выполнения их работы. Для эффективной работы этим лидерам необходима возможность подбирать определённые типы контента для различных сценариев использования, в разных контекстах и на разных языках и в разных форматах. В офлайн-ситуациях (отключения электричества, отсутствие доступа к интернету или во время отключений интернета) возможность успешно проводить тренинги и доставлять контент становится практически невозможной. \
> \
> Они неоднократно отмечали, что если бы у них не было Butter Box, некоторые сессии пришлось бы отменить.
### 2. Обмен файлами и резервное копирование медиа
> Часто М. хочет поделиться музыкальными и видеофайлами, которые они загрузили на свой компьютер, с друзьями — но передача через кабели или Bluetooth — это мучение. Поэтому они настроили Butter Box со своей медиаколлекцией — музыкальные файлы, фильмы и фотографии. Они подключили его рядом с кухней, и теперь любой в их квартире может подключиться к Wi-Fi Butter и просматривать общую медиатеку. Интернет не нужен, и больше никаких поштучных передач файлов.
### 3. Временное хранение файлов
> На удалённом объекте без сотовой связи рабочим нужен был способ временно выгрузить большие файлы — например, фотографии объекта или документы — со своих телефонов. Используя локальную зашифрованную доску сообщений Butter Box, они отправляли файлы себе или коллегам на хранение. Файлы оставались на устройстве до их получения позже, даже без питания или сигнала.

View file

@ -0,0 +1,9 @@
---
title: "Приложения"
nav_order: 2
parent: "Наборы контента"
---
# Приложения
Если вы назовёте папку `appstore` и поместите её в корневую директорию USB-накопителя, на портале Butter Box появится иконка **Приложения**.

View file

@ -0,0 +1,50 @@
---
title: "Наборы контента"
nav_order: 5
has_children: true
permalink: /content-packs/
---
# Наборы контента
Вы можете создать свой собственный набор контента! Его просто нужно оформить как **статический сайт с локальными ссылками**. Этот сайт будет работать непосредственно с устройства, поэтому все изображения и файлы, необходимые для сайта, должны находиться в одной главной папке.
Когда ваш статический сайт будет готов, поместите все необходимые файлы в одну папку и разместите эту папку в **корневой директории** вашего USB-накопителя. Этот сайт будет отображаться в браузере, через который пользователи получают доступ к порталу Butter Box.
Советы по созданию набора контента со статическим сайтом:
* **Содержимое.** Всё для статического сайта должно храниться на USB-накопителе, подключённом к Butter Box. Сайт не должен ссылаться на ресурсы в глобальном интернете.
* **Размер.** Размер вашего набора контента ограничен доступным пространством на USB-накопителе. При этом учитывайте, что если несколько человек одновременно скачивают или просматривают очень большие файлы с устройства, возможны задержки.
* **Страницы.** Ссылки между страницами должны вести на другие сохранённые страницы в той же папке, а не в интернет. Необходимо использовать относительные пути (например, about/index.html) вместо абсолютных веб-URL.
* **Медиа.** Изображения, видео и звуки не могут ссылаться на онлайн-ресурсы. Файлы должны находиться в папке вашего сайта и храниться на USB-накопителе.
* **Библиотеки.** Сайт не может использовать JavaScript-библиотеки, которые зависят от интернет-соединения.
* **Стили.** Специальные шрифты и иконки (например, из Google Fonts) также должны находиться в папке, а не загружаться из сети.
### Попробуйте
* Приведённый ниже zip-файл содержит пример статического сайта. Чтобы понять, как статические сайты работают с Butter — скачайте его. Распакуйте. Затем добавьте этот набор файлов на ваш USB-накопитель.
[Скачать файл](/img/docs/Sample%20Static%20Website.zip)
### Начните работу
Лучший способ начать создание собственного набора контента — это определиться с идеей о том, какой опыт и какую информацию вы хотите предоставить, а затем спроектировать и создать для этого локальный статический сайт.
Это может быть что-то очень простое, например, аудиоплеер для музыки. Или список из пяти лучших VPN-приложений, которые вы рекомендуете. Или например библиотека, база знаний культурных артефактов.
### Добавьте файлы сайта на USB-накопитель
Поместите папку с файлами сайта в **корневую директорию** 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, нажмите **Файлы**. Перейдите в папку сайта. Нажмите для просмотра.

View file

@ -0,0 +1,38 @@
---
title: "Карты"
nav_order: 1
parent: "Наборы контента"
---
# Карты
Вы можете сделать офлайн-карты доступными через ваш Butter Box. Эти карты работают на основе **OpenStreetMap (OSM)** и приложения **OsmAnd** для Android.
> **Внимание:**
> **Важно:** Загрузка офлайн-карт работает **только на устройствах Android**. iOS не поддерживается.
### ✅ Шаги для включения офлайн-карт
**1. Скачайте приложение OsmAnd (APK для Android)**
* Перейдите по ссылке: [Бесплатные версии OsmAnd — Android](https://osmand.net/docs/versions/free-versions)
* Скачайте последний APK-файл.
**2. Скачайте нужные файлы карт**
* Перейдите по ссылке: [Список локальных индексов OsmAnd](https://osmand.net/list?sortby=size\&asc=false)
* Выберите и скачайте регионы, которые хотите использовать офлайн.
**3. Организуйте файлы**
* На USB-накопителе создайте папку с именем `osm-map-files` .
* Поместите **APK-файл OsmAnd** и все ваши **файлы карт** в эту папку.
![Директория USB при просмотре в Finder на компьютере](/img/docs/Screenshot%202025-08-16%20at%209.44.40%20PM.png)
**4. Добавьте на Butter Box**
* Вставьте USB-накопитель в Butter Box.
* Иконка **Офлайн-карты** автоматически появится на портале Butter Box.
👉 Вот и всё — теперь любой пользователь с **устройством Android** может скачать OsmAnd и офлайн-карты, которые вы предоставили, прямо с вашего Butter Box.

View file

@ -0,0 +1,57 @@
---
title: "Как переформатировать USB-накопитель"
nav_order: 1
parent: "Часто задаваемые вопросы"
---
# Как переформатировать USB-накопитель
После подключения USB-накопителя к Raspberry Pi вы увидите заголовок «Обзор USB» на портале. Если вы обновили страницу портала и по-прежнему не видите иконку «Обзор USB», возможно, вам нужно стереть данные с USB-накопителя и переформатировать его.
![](/img/docs/unknown.png)
Когда вы форматируете USB-накопитель, все файлы и папки на нём удаляются и заменяются новой файловой системой. Это может помочь устранить проблемы с самим накопителем или сделать его совместимым с новыми файлами, которые вы хотите перенести. Обязательно сделайте резервную копию файлов перед форматированием накопителя.
**Проверьте формат USB-накопителя**
* На настольном компьютере или ноутбуке подключите USB-накопитель
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
* Нажмите «Свойства» и проверьте формат
* Ваш USB-накопитель должен быть отформатирован в ExFat, Fat32 или MS-DOS (FAT).
**Шаги переформатирования на MacOS:**
* Подключите USB-накопитель к USB-порту компьютера.
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
* Нажмите «Стереть диск…»
* На этом этапе вы можете переименовать USB-накопитель
* Выберите правильный формат: ExFat, ExFat32 или MS-DOS (FAT)
* Затем нажмите «Стереть»
* Может появиться предупреждение о том, что весь контент будет удалён. Нажмите «Стереть»
* Это может занять несколько минут. USB-накопитель исчезнет и снова появится на рабочем столе
* Убедитесь, что накопитель правильно отформатирован
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
* Нажмите «Свойства» и проверьте формат
**Шаги переформатирования на Windows:**
* Подключите USB-накопитель к USB-порту компьютера.
* Откройте Проводник и выберите «Этот компьютер» в меню.
* Вы найдёте этот пункт на левой панели, рядом со значком монитора.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
* В Windows 7 нажмите «Компьютер» в правой части окна «Пуск».
* Нажмите правой кнопкой мыши на значок флеш-накопителя. Он находится под заголовком «Устройства и диски» в середине страницы. Появится выпадающее меню.
* Выберите «Форматировать». Откроется окно форматирования.
* Нажмите на «Файловая система» и выберите формат MS-DOS, FAT32 или exFAT.
* [FAT32](https://www.wikihow.com/Format-FAT32) — наиболее совместимый формат. Работает с большинством компьютеров и игровых консолей.
* exFAT — похож на FAT32, но разработан для внешних жёстких дисков (например, флеш-накопителей) и более быстрого использования. Это универсальный формат, наиболее распространённый в Windows, Linux и Mac.
* Нажмите «Начать» и «ОК» для завершения форматирования флеш-накопителя.
* Появится последний запрос, нажмите «ОК». Ваш флеш-накопитель успешно отформатирован.
![](</img/docs/unknown (1).png>)![](<../assets/images/unknown (2).png>)![](<../assets/images/unknown (3).png>)
![](</img/docs/unknown (4).png>)
![](</img/docs/unknown (5).png>)

Some files were not shown because too many files have changed in this diff Show more