6 FAQs
6.1 Why aren’t my changes appearing on the website?
There are a few things that could be the cause:
You forgot to build your book. Remember that this step is what creates the HTML files for the website.
You forgot to commit and push your changes. The build step creates the HTML files, but you need to push them to Github after building - otherwise, they only live on your computer.
You just haven’t waited long enough - it takes 1-2 minutes for the site to build.
6.3 Why aren’t my links to external sites working?
You’ve probably forgotten to include the http:// or https:// at the beginning of the URL. By default, Bookdown assumes that you’re trying to link to another part of your Bookdown site. The http:// tells Bookdown that you are linking to an external site.
6.4 Why aren’t my git pull commands working?
If you receive this output when running git pull:
hint: You have divergent branches and need to specify how to reconcile them.
[...]
fatal: Need to specify how to reconcile divergent branches.
This is not a merge conflict. It’s a one-time setup question from Git asking you to choose your preferred strategy for dealing with merge conflicts. We recommend running the below in any folder:
git config --global pull.rebase false You can then git pull.
6.2 What are the unusual symbols I’m seeing?
<!– –!>
These are comment tags - they prevent the contents inside them from being displayed. You can either type/delete them manually or use the shortcuts
Command + Shift + C(Mac) orCtrl + Shift + C(Windows).[ ]( )
This is the markdown syntax for a hyperlink. The contents of the square brackets indicate the text to be displayed, and the round brackets contain the link itself.