Как развернуть mdbook на GitHub - PullRequest
0 голосов
/ 16 марта 2020

У меня проблемы с развертыванием моей книги на страницах GitHub. Может кто-нибудь из вас объяснит мне шаг за шагом, как развернуть в самых простых руках?

Первая попытка Развертывание книги на страницах GitHub с travis.yml . Я пытался с токенами и travis.yml, но что-то не работает.

  1. Go на Travis-ci.com и зарегистрироваться с GitHub.
  2. Принять авторизацию Travis CI. Вы будете перенаправлены на GitHub.
  3. Нажмите на изображение своего профиля в правом верхнем углу панели инструментов Travis, нажмите зеленую кнопку «Активировать» и выберите репозитории, которые вы хотите использовать с Travis CI.
  4. Создайте новый токен
  5. Go на странице настроек Travis CI вашего хранилища и добавьте переменную среды с именем GITHUB_TOKEN, которая помечена как безопасная и не отображается в журналах. Как?

  6. Создать файл travis.yml в моей локальной папке или в удаленной папке репозитория GitHub?

  7. После того, что я должен сделать?

Код, который я вставил в travis.yml

deploy:
  provider: pages
  skip-cleanup: true
  github-token: $GITHUB_TOKEN
  local-dir: path / to / mybook / book
  keep-history: false
  on:
    branch: master

Я впервые на GitHub и Я не знаю ни одной команды, я учусь сейчас.

Вторая попытка Развертывание на GitHub Pages вручную. Первый раз, когда это сработало. Но создание нового репозитория дает мне ошибку относительно временной папки (номер 7). Какова правильная процедура? Я перечисляю все шаги, которые я предпринял для создания книги

  1. локально клонировал репо $ git clone ... repo.git
  2. $ mdbook init --theme
  3. Я добавил все файлы * .md в папке sr c /
  4. я изменяю SUMMARY.md
  5.  $ git add -A
     $ git push```
    
  6. я создаю ветку gh-pages git branch gh-pages
  7. $ git worktree add / tmp / book gh-pages fatal: '/ tmp / book' already exists Если я использую другой каталог, например, tmp / book2, он будет корректно продолжаться в течение нескольких шагов
  8. $ mdbook build
  9. $ rm -rf / tmp / book2 / *
  10. $ cp -rp book2 / * / tmp / book2 / Еще одна ошибка здесь! cp: book2/*: No such file or directory. В первый раз он не дал мне ошибок. Что я делаю не так в команде linux?
  11. $ cd / tmp / book2
  12. $ git add -A
  13. $ git commit 'new book message'
  14. $ git push origin gh-pages
  15. $ cd -
Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...