¶ MIEM Wiki
¶ Установка
¶ Для разработки:
npm i
npm run dev
Для публикации:
npm i --only=prod
npm run build
npm run start
Для использования в проде достаточно оставить только следующие файлы в проекте:
assets/ minified frontend files
cache/ subsidiary cache and uploads
server/ backend
config.yml configs for running server
LICENSE
package.json
package-lock.json
¶ Фичи
По возможности старался в тех местах, где делал правки, оставлять комментарии типа
// <Miem>
// </Miem>
чтобы было проще искать исправления/дополнения
¶ 1. Меню
Общее МИЭМовское меню для переключения между сервисами. Вставляется вместо логотипа Wiki.js.
Компонент: client/miem/components/miem-menu.vue
Где вставить: client/components/common/nav-header.vue:26
¶ 2. Заголовок как кнопка "Домой"
В оригинальной версии движка клик по логотипу в верхнем левом углу страницы редиректил на домашнюю страницу. Теперь его нет, так что его роль выполняет заголовок - он теперь кнопка.
Компонент: client/miem/components/miem-title.vue
Где вставить: client/themes/default/components/page.vue:52
¶ 3. Оглавление в мобильной версии
Добавил оглавление в мобильную версию. Открывается по кнопке в нижнем правом углу.
Компонент: client/miem/components/miem-mobile-contents-table.vue
Где вставить: client/themes/default/components/page.vue:4
¶ 4. Иконки ресурсов в ссылках
Решили для наглядности пририсовывать перед некоторыми ссылками в псевдокласс :before иконки соответствующих сервисов. Все стили прописаны здесь:
SCSS файл: client/miem/scss/miem-links.scss
Импортится он в client/themes/default/scss/app.scss. Это главный файл со стилями, которые используются в UI Wiki.js
¶ 5. Favicon
Заменили все фавиконы
client/static/favicons/favicon-16x16.png
client/static/favicons/favicon-32x32.png
client/static/favicon-32x32.png
¶ 6. Оглавление на десктопе теперь справа, а не по центру
Сделали так, чтобы контент статьи был по центру, что многим кажется логичным.
Код здесь: client/themes/default/components/page.vue:235-250
¶ 7. Карточки меню с закладками, шэрингом, печатью и с автором последних изменений теперь в заголовочной области
Теперь там нет пустого места + они не мешают наслаждаться чтением
Код здесь: client/themes/default/components/page.vue:60-101
¶ 8. Теги теперь внизу страницы, перед комментариями
Код здесь: client/themes/default/components/page.vue:196-216
¶ Исправления
¶ 1. Исправление несостыковок в переводе
Кое-где у движка не завершен перевод. Пришлось захардкодить перевод.
client/components/admin/admin-general.vue:113
v-toolbar-title.subtitle-1 Особенности
client/components/admin/admin-general.vue:149
label='Комментарии'
client/components/admin/admin-general.vue:153
hint='Дать возможность пользователям оставлять комментарии на странице'
¶ 6. Удалить лишние пункты (v-list-items) из меню "Поделиться"
В дефолтном меню social sharing были ресурсы, которые к МИЭМу не относятся или не нужны вовсе. Оставили только необходимое.
client/components/common/social-sharing.vue:3-17
¶ Стилизация оформления
Делаем движок чуть более подходящим к МИЭМовской стилистике
Стили указываются не в коде, а в админке Wiki. Поэтому прикрепляю сниппет.