Giter Club home page Giter Club logo

template's Introduction

STEP 1 - Get the machinery running ⚙️

Fork this repository

Enable actions

Go to the Actions tab in your forked repo, and click the green button that says "I understand my actions, go ahead and enable them".

Create a GitHub access token

🔑

Follow these steps and make sure that you check the repo, admin:repo_hook and workflow boxes while creating your access token.

Create an encrypted secret for your repo

🕵️‍♀️

Simply follow these steps.

The name of the secret must be PAT_BOT and the value must be the key you obtained from the previous step.

Push a dummy change to the master

📤

It can be anything, such as simply editing this README.md file you are reading at the moment. @sofievdbos: Done!

What now ?

👀

After pushing your changes to the master branch, visit the Actions tab of your repository. You should see an action named Build proceeding PDF, which consists of two steps buildPDF and buildHugo.

Soon after a successful action run, your web page will be deployed. You should see Environments section appeared in your repository (on the right column). In the Environments page, click the View Deployment button to visit your report page! At this stage, it should be identical to the BrainHack proceedings template webpage.

Unless you change the name of the repo you forked from template to something else, your page will be published at your_GitHub_handle.github.io/template.

STEP 2 - Edit your report ✍️

  • Place your figures in the figures folder.

  • Edit report.md file to create your own report. The template markdown will walk you through how to cite references, add figures and equations etc.

  • Edit report.bib to add your bibliography in BibTeX format.

⚠️ Warning
Please do not change the name or the location of report.md and report.bib. Unless you provide an absolute path for your figures, they will be looked for in the figures folder.

Whenever you push your changes to the master branch (either directly or via merging a branch), GitHub actions will be triggered to update your report. That's it!

If actions run completes successfully, 🟠 (running) will turn into ✅ (success). If your build fails, you will see ❌ instead. In that case, you can read the logs to see what went wrong.

template's People

Contributors

agahkarakuzu avatar katjaq avatar sofievdbos avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.