{"action":"created","issue":{"url":"https://api.github.com/repos/jekyll/jekyll/issues/3385","labels_url":"https://api.github.com/repos/jekyll/jekyll/issues/3385/labels{/name}","comments_url":"https://api.github.com/repos/jekyll/jekyll/issues/3385/comments","events_url":"https://api.github.com/repos/jekyll/jekyll/issues/3385/events","html_url":"https://github.com/jekyll/jekyll/issues/3385","id":56069083,"number":3385,"title":"Docs about github pages","user":{"login":"FernandoBasso","id":6560620,"avatar_url":"https://avatars.githubusercontent.com/u/6560620?v=3","gravatar_id":"","url":"https://api.github.com/users/FernandoBasso","html_url":"https://github.com/FernandoBasso","followers_url":"https://api.github.com/users/FernandoBasso/followers","following_url":"https://api.github.com/users/FernandoBasso/following{/other_user}","gists_url":"https://api.github.com/users/FernandoBasso/gists{/gist_id}","starred_url":"https://api.github.com/users/FernandoBasso/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/FernandoBasso/subscriptions","organizations_url":"https://api.github.com/users/FernandoBasso/orgs","repos_url":"https://api.github.com/users/FernandoBasso/repos","events_url":"https://api.github.com/users/FernandoBasso/events{/privacy}","received_events_url":"https://api.github.com/users/FernandoBasso/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":2,"created_at":"2015-01-30T18:43:40Z","updated_at":"2015-12-13T20:49:46Z","closed_at":"2015-12-13T20:49:46Z","body":"I spent sometime reading http://jekyllrb.com/docs/github-pages/ today. My goal was to be able to test locally. The problem was that even though I was using `jekyll serve --baseurl ''`, it worked for the first time and loaded the page, and then, every time I ran `jekyll build`, stylesheets would not be loaded because the href stylesheets pointed to a url containing the `/project-name` path part.\r\n\r\nI think it would be nice to mention in http://jekyllrb.com/docs/github-pages/#project-page-url-structure that when one runs `jekyll serve --baseurl ''`, it will keep watching for changes and rebuilding *automatically* with the *correct* URL, and one *doesn't* need to keep building the sources manually (or use `--watch`), which then prevents links for working correctly when previewing the site locally.\r\n\r\nEDIT: I was pointed two links in #jekyll. One of them,\r\n\r\nhttp://jekyllrb.com/docs/configuration/#serve-command-options\r\n\r\nclearly explains: \"the `serve` sub-command can accept any of the options for the build sub-command, which are then applied to the **site build** which occurs **right before your site is served**.\" So, I guess that the docs about github pages could just reinforce the idea that running `jekyll serve` builds the site and keeps watching for changes automatically and then point to the above link about the `serve` command, or, at least just point to that link. Not everyone reads the *entire* docs before using jekyll. I guess most people read as they need and sometimes when you are doing something, you still lack knowledge about other related and important concepts it it is not always clear that you are just missing some specific topic in the help pages.\r\n\r\nThe other link that I was pointed to was\r\n\r\nhttps://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/\r\n\r\nPerhaps that one could also be useful, idk.\r\n \r\n"},"comment":{"url":"https://api.github.com/repos/jekyll/jekyll/issues/comments/164296815","html_url":"https://github.com/jekyll/jekyll/issues/3385#issuecomment-164296815","issue_url":"https://api.github.com/repos/jekyll/jekyll/issues/3385","id":164296815,"user":{"login":"parkr","id":237985,"avatar_url":"https://avatars.githubusercontent.com/u/237985?v=3","gravatar_id":"","url":"https://api.github.com/users/parkr","html_url":"https://github.com/parkr","followers_url":"https://api.github.com/users/parkr/followers","following_url":"https://api.github.com/users/parkr/following{/other_user}","gists_url":"https://api.github.com/users/parkr/gists{/gist_id}","starred_url":"https://api.github.com/users/parkr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/parkr/subscriptions","organizations_url":"https://api.github.com/users/parkr/orgs","repos_url":"https://api.github.com/users/parkr/repos","events_url":"https://api.github.com/users/parkr/events{/privacy}","received_events_url":"https://api.github.com/users/parkr/received_events","type":"User","site_admin":false},"created_at":"2015-12-13T20:49:46Z","updated_at":"2015-12-13T20:49:46Z","body":"Please submit a PR for this if you'd like – I am happy to see some rewording of how we explain baseurl if that is what you're driving at. Thank you!"}}