Как правильно скомпилировать загрузочную документацию и открыть ее локально?

Question

Я загрузил исходный код Bootstrap v5 и скомпилировал документы с помощьюnpm run docsкак рекламируется. Я вижу, что процесс компилирует документы и сохраняет их в:

./bootstrap-5.0.0-alpha1/_gh_pages/docs/5.0/...

Этот каталог содержит несколько index.htmlфайлы в подкаталогах. Однако, если я открою один из них, все они будут содержать перенаправление наhttps://v5.getbootstrap.com/docs/5.0/getting-started/introduction поэтому я не могу открыть свои локальные файлы.

<meta http-equiv="refresh" content="0; url=https://v5.getbootstrap.com/docs/5.0/getting-started/introduction/">

Я хотел бы использовать систему документации Bootstrap для своей собственной документации, кто-нибудь знает, что мне здесь не хватает?

Answer 1

Сначала загрузите исходный код v5.0.0-alpha1.

cd bootstrap-5.0.0-alpha1/

npm install

Затем вы можете запустить документацию локально через:

npm run docs-serve

Если все идет гладко, вы должны увидеть что-то вроде:

Web Server is available at http://localhost:9001/

Теперь, когда вы просматриваете этот локальный URL-адрес, документация будет обслуживаться с localhost. Чтобы найти документы на вашем компьютере, они хранятся в /bootstrap-5.0.0-alpha1/site/content/docs/5.0 как файлы разметки.