vuepress наступает на яму

Node.js внешний интерфейс Vue.js Webpack VuePress

Vuepress — это совершенно новый генератор статических веб-сайтов на основе Vue, выпущенный Youda 12 апреля. На самом деле это спа-приложение Vue со встроенным веб-пакетом, который можно использовать для написания документов. Случилось так, что мне недавно нужно было написать документацию на некоторые компоненты, поэтому я запустил волну, ведь она только вышла и столкнулась с множеством ям, и в итоге побежала ухабисто, чтобы все не наступали на одни и те же ямы. , Я намеренно записал процесс строительства. Сходите и поделитесь волной.

Вот несколько известных проблем

  • Поскольку util.promisify был введен после Node 8.0, если вы не хотите тратить три часа, как я, пожалуйстаПроверить и обновить версию узла

  • Не рекомендуется использовать для тестирования шаблон webpack-simple, иначе он не будет работать ╮(╯▽╰)╭

  • Если вы используете шаблон cli, если сообщается об ошибке TypeError: Cannot read property 'vue' of undefined, это связано с тем, что версия, используемая vueloader встроенного веб-пакета vuepress, отличается от вашей локальной версии. Пожалуйста, обновите с локальной версии на последнюю стабильную версию

  • Когда он переходит на 404 после установки официального развертывания документа, используйте хэш-режим маршрута для доступа

  • Если вы столкнулись с такими проблемами, как конфликты портов, создайте новую папку .vuepress в каталоге docs, а затем создайте новый файл конфигурации для настройки элемента prot port.Подробнее см.официальная документация

  • Если установить его в проект после глобальной установки, то зависимости будут конфликтовать, в результате чего сборка модуля не удалась: CssSyntaxError , рекомендуется писать в глобальный файл vuepress

начать использовать

Используйте cli для создания нового проекта шаблона веб-пакета

    //进入项目首先安装依赖
    npm install
    
    //将vue-loader进行版本替换，使其和vuepress内置的webpack里的vue-loader保持一致，否则会报错（不过尤大大已经在解决版本冲突的问题了，版本待发）
    npm install vue-loader@15.0.0-rc.2 --save-dev
    
    //接下来安装vuepress
	npm install -D vuepress
	
	mkdir docs
	
	echo "# Hello VuePress" > docs/README.md
	
	//最后一步启动vuepress
	npx vuepress dev docs
	
	//使用vuepress build即可完成对项目的打包
	
	//接下来就是按照官方的文档，对你的网站进行各种创造啦

Для развертывания проекта я использую github, пожалуйста, обратитесь к конкретной операцииофициальная документация

Пример веб-сайта

гитхаб-адрес

Остальная часть справочника по настройке темыофициальная документацияПодробная конфигурация в порядке, поэтому я не буду вдаваться в подробности.

Категории