Self publishing

Ruben Taelman edited this page Nov 5, 2018 · 5 revisions

In order to share your article's message with the world, a good practise is to self-publish your article somewhere to avoid that people have to go through a paywall to read it.

The output of ScholarMarkdown is a static webpage, which can easily be published on any Web server.

If you don't have a Web server at your disposal, you could use GitHub pages to publish it on a GitHub domain. When combined with the Travis continuous integration tool, you could set up a system that will automatically re-publish your article every time you commit a change to GitHub. A detailed guide on how to do this can be found here: https://docs.travis-ci.com/user/deployment/pages/ Create your GITHUB_TOKEN here: https://github.com/settings/tokens (requires at least repo access)

note: Make sure that you deploy the output folder to GitHub pages by adding the following line to your deploy block: local-dir: output.

Example of an article that is automatically published using Travis and GitHub Pages: https://rdfostrich.github.io/article-mocha-2018/ (source)

Reference contents of .travis.yml:

language: ruby
rvm:
  - 2.4.0
bundler_args: --without development
script:
  - bundle exec nanoc compile
  - bundle exec nanoc check internal_links mixed_content stale
cache:
  - bundler
deploy:
  provider: pages
  local-dir: output
  skip-cleanup: true
  github-token: $GITHUB_TOKEN  # Set in the settings page of your repository, as a secure variable
  keep-history: true
  on:
    branch: master
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.