Skip to content

Commit

Permalink
Add support page. Refactor index pages (#199)
Browse files Browse the repository at this point in the history
  • Loading branch information
Kanaduchi authored Dec 12, 2023
1 parent 066cf93 commit 9083213
Show file tree
Hide file tree
Showing 13 changed files with 190 additions and 54 deletions.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Binary file added docs/images/btc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 6 additions & 4 deletions docs/index.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,15 @@ comments: false
</style>

!!! give-money inline end "Support VWCoding"
If you like this project you can support it by online transfer to our wallet using Yandex transfer system:
Currently unavailable

If you liked this project and are ready to support it for further development, you can do so using:

![BTC wallet](images/btc.png){ width="100" align=left }

BTC Wallet: `1BKR5d91YUic3aqwc6nTGTMLkGBBrZkkcj`

!!! info "Translation is in progress"
Currently this site is written in Russian language.
If you want to help in translating pages to English language please [follow the instructions](https://github.com/Kanaduchi/vwcoding/blob/master/CONTRIBUTING.md)
If you want to help in translating pages to English language please [follow the instructions](support/#adding-localizations)

!!! danger "Warning!"
Sharing information from this site is allowed only with the copyright notice and link to this resource.
Expand Down
35 changes: 10 additions & 25 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,28 @@
---
title: Кодирование автомобилей VAG
hide:
- toc
comments: false
ᴴₒᴴₒᴴₒ: true
---
<script src="https://www.moneybutton.com/moneybutton.js"></script>
<style>
.md-typeset h1,
.md-content__button {
display: none;
}

.frame {
width: 1600px;
max-width: none !important;
height: auto;
border: 0;
-ms-transform: scale(0.65);
-moz-transform: scale(0.65);
-o-transform: scale(0.65);
-webkit-transform: scale(0.65);
transform: scale(0.65);

-ms-transform-origin: 0 0;
-moz-transform-origin: 0 0;
-o-transform-origin: 0 0;
-webkit-transform-origin: 0 0;
transform-origin: 0 0;
}
.wrap {
width: auto;
height: 35px;
}
</style>

!!! give-money inline end "Помощь проекту"
Если вам понравился этот проект и вы готовы его поддержать для дальнейшего развития, то вы можете это сделать с российских карт
с помощью Яндекс-перевода в рублях:
<div class="wrap"><iframe class="frame" src="https://yoomoney.ru/quickpay/fundraise/button?billNumber=szaulwUCpas.221202&" frameborder="0" allowtransparency="true"></iframe></div>
с помощью Яндекс-перевода в рублях:
[Поддержать :fontawesome-solid-paper-plane:](https://yoomoney.ru/to/4100110582992748/100){ .md-button }

либо с помощью

![BTC wallet](images/btc.png){ width="100" align=left }

BTC Wallet: `1BKR5d91YUic3aqwc6nTGTMLkGBBrZkkcj`

!!! danger "Внимание!"
Копирование информации с сайта допускается только с указанием ссылки на данный ресурс

Expand Down
75 changes: 75 additions & 0 deletions docs/support.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Support and contributing

## Donation and support

If you liked this project and are ready to support it for further development,
you can do so using Bitcoin:

<div class="grid cards" markdown>

- :fontawesome-brands-btc:{ .lg .middle } __Cryptocurrency__

---
![BTC wallet](./images/btc.png){ width="100" align=left }

BTC Wallet: `1BKR5d91YUic3aqwc6nTGTMLkGBBrZkkcj`

</div>

## Contributing

### Structure of the project

Path to docs: `/docs`
Path to images: `/docs/images`
Path to firmwares: `/docs/firmwares`
Path to parameter files: `/docs/parameters`
Path to templates (e.g. used in utils): `/overrides/pages`

Main configuration file: `mkdocs.yml`

### Adding new codings

You can use the template below to add new codings

```
### Name of coding / adaptation
!!! tip ""
Tip/info message
!!! warning ""
Some warning message
``` yaml title="логин-пароль: XXXXX (if applicable)"
Block XX → Adaptation/Coding:
Byte XX – Bit X (name): Active
Name of volume/folder:
- Name of parameter: activate
→ Apply
```
??? note "Collapsibale list"
This information is displayed collapsed on the site
```

Inserting image to the page:
```![Screenshot](../images/***/imageName.png)```

Inserting file to the page:
```[(Name of file)](LinkToFile)```

### Adding localizations

If you want to help in translating this site to English language, please contribute a localization!

Follow these steps to add a localization:

1. Copy particular file in /docs directory to new with lang suffix. Example: drive.md → drive.en.md
2. Start translating the strings
3. Edit mkdocs.yaml and edit the following variables. Make sure that all navigation items translated correctly
```yaml
nav_translations:
Name in Russian: Name in English
```
4. Create a PR with your localization updates.
66 changes: 66 additions & 0 deletions docs/support.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# Поддержка и развитие проекта

## Помощь проекту

Если вам понравился этот проект и вы готовы его поддержать для дальнейшего развития,
то вы можете это сделать с помощью Яндекс-перевода в рублях или биткоина:

<div class="grid cards" markdown>

- :fontawesome-solid-money-bill:{ .lg .middle } __Перевод с российских карт__

---
Перевод в рублях c помощью карты или кошелька Яндекс

[Поддержать :fontawesome-solid-paper-plane:](https://yoomoney.ru/to/4100110582992748/100){ .md-button }

- :fontawesome-brands-btc:{ .lg .middle } __Криптовалюта__

---
![BTC wallet](./images/btc.png){ width="100" align=left }

Перевод на BTC кошелек: `1BKR5d91YUic3aqwc6nTGTMLkGBBrZkkcj`

</div>

## Добавление новых материалов

### Структура сайта

Путь для хранения изображений: `/docs/images`
Путь до прошивок: `/docs/firmwares`
Путь до параметрий: `/docs/parameters`

### Добавление новых кодировок

Данный сайт построен с использованием языка разметки Markdown.

Шаблон для страниц:

```
# Название страницы
### Название кодировки/адаптации
!!! tip ""
Описание/Цель, если есть
!!! warning ""
Предупреждение, если есть
``` yaml title="логин-пароль: XXXXX (если есть)"
Блок XX → Адаптация/Кодирование:
Байт XX – Бит X (название бита): Активировать
Название раздела:
- Название адаптации: Активировать
→ Применить
```
??? note "Название раскрывающегося списка"
Здесь находится информация, которая по умолчанию на сайте отображается свернутой
```

Пример вставки изображений на страницу сайта:
```![Screenshot](../images/MQB/odis-e-tires.png)```

Пример вставки файлов на страницу сайта:
```[(Сборка для Skoda)](../firmwares/TMC-zz.rar)```
File renamed without changes.
File renamed without changes.
56 changes: 32 additions & 24 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -57,23 +57,19 @@ theme:
- content.code.annotate
- content.code.copy
- content.tooltips
# - content.tabs.link
# - header.autohide
- navigation.expand
- navigation.footer
# - navigation.prune
- navigation.indexes
# - navigation.instant
# - navigation.sections
- navigation.instant
- navigation.instant.progress
- navigation.path
- navigation.tabs
# - navigation.tabs.sticky
- navigation.top
- navigation.tracking
- search.highlight
- search.share
- search.suggest
- announce.dismiss
# - toc.integrate
- toc.follow

extra_css:
Expand Down Expand Up @@ -118,6 +114,7 @@ plugins:
nav_translations:
Общая информация: Main information
Платформа MQB: MQB platform
Платформа MQB-Evo: MQB-Evo platform
Информация: Information
Кодирование автомобилей VAG: Coding of VW cars
Платформа MLB/MLB-Evo: MLB/MLB-Evo platform
Expand All @@ -134,7 +131,7 @@ plugins:
Инструкция ODIS E: ODIS E instruction
Обратная связь: Feedback
История изменений: History of changes
Поддержать проект: Support of project
Поддержка и развитие проекта: Support and contributing

Ассистенты водителя: Drive assistance
Активация ACC и pACC: ACC & PACC activation
Expand Down Expand Up @@ -226,12 +223,14 @@ markdown_extensions:

nav:
- Общая информация:
- Кодирование автомобилей VAG: index.md
- Платформа MQB: MQB/main.md
- Платформа MLB/MLB-Evo: MLB-Evo/main.md
- Платформа PQ26: PQ26/main.md
- Платформа PQ35: PQ35/main.md
- index.md
- Платформа MQB: MQB/index.md
# - Платформа MQB-Evo: index.md
- Платформа MLB/MLB-Evo: MLB-Evo/index.md
- Платформа PQ26: PQ26/index.md
- Платформа PQ35: PQ35/index.md
- Инструменты и адаптеры:
- utils/index.md
- Редактор параметрий: utils/datasetEditor.md
- Калькулятор длинного кодирования: utils/longCoding.md
- FEC генератор: utils/fec.md
Expand All @@ -241,9 +240,18 @@ nav:
- Инструкция ODIS E: utils/odis-e.md
- История изменений: history.md
- Обратная связь: questions.md
- Поддержать проект: https://yoomoney.ru/to/4100110582992748/100
- Платформа MQB:
- Информация: MQB/main.md
- Поддержка и развитие проекта: support.md
- Инструменты и адаптеры:
- utils/index.md
- Редактор параметрий: utils/datasetEditor.md
- Калькулятор длинного кодирования: utils/longCoding.md
- FEC генератор: utils/fec.md
- XOR калькулятор: utils/xorCalculator.md
- Генератор параметрии шин: utils/tiresCoding.md
- Список программ и адаптеров: utils/programs.md
- Инструкция ODIS E: utils/odis-e.md
- MQB:
- MQB/index.md
- Ассистенты водителя:
- Активация ACC и pACC: MQB/pACC.md
- Кодирование ACC: MQB/ACC_coding.md
Expand Down Expand Up @@ -277,8 +285,9 @@ nav:
- Кодирование: MQB/tires.md
- Дооснащение: MQB/addons.md
- Eeprom память: MQB/eeprom.md
- Платформа MLB/MLB-Evo:
- Информация: MLB-Evo/main.md
# - MQB-Evo: index.md
- MLB/MLB-Evo:
- MLB-Evo/index.md
- Ассистенты водителя: MLB-Evo/assistants.md
- Движение и управление: MLB-Evo/drive.md
- Безопасность. Отпирание и запирание: MLB-Evo/security.md
Expand All @@ -287,8 +296,8 @@ nav:
- Освещение: MLB-Evo/lights.md
- Приборная панель: MLB-Evo/AID.md
- Головное устройство: MLB-Evo/headDevice.md
- Платформа PQ26:
- Информация: PQ26/main.md
- PQ26:
- PQ26/index.md
- Освещение:
- Управление освещением: PQ26/lights.md
- Нестандартные световые решения: PQ26/extraLights.md
Expand All @@ -306,8 +315,8 @@ nav:
- Мультимедиа: PQ26/multimedia.md
- Дооснащение: PQ26/addons.md
- Словарь немецких терминов: PQ26/german.md
- Платформа PQ35:
- Информация: PQ35/main.md
- PQ35:
- PQ35/index.md
- Управление и динамика: PQ35/drive.md
- Свет: PQ35/lights.md
- Мультимедиа: PQ35/multimedia.md
Expand All @@ -319,5 +328,4 @@ nav:
- Свет: PQ35/Tiguan/lights.md
- Приборная панель: PQ35/Tiguan/instrPanel.md
- Мультимедиа: PQ35/Tiguan/multimedia.md
- Инструменты: utils/main.md
- Поддержать проект: https://yoomoney.ru/to/4100110582992748/100
- Поддержка и развитие проекта: support.md
2 changes: 1 addition & 1 deletion requirements.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
mkdocs-material==9.5.1
mkdocs-material==9.5.2
mkdocs-print-site-plugin==2.3.6
mkdocs-static-i18n==1.2.0
mkdocs-git-revision-date-localized-plugin==1.2.1

0 comments on commit 9083213

Please sign in to comment.