Giters

eliflores / my-profile-com-mx

Build your personal site and blog using Hugo - http://gohugo.io/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

academicbloghugo

Who are we?

  • Ely Flores

    • Software Engineer @ Nearsoft
    • UABC / ENSEIRB
    • Code. Java. Web. Star Wars. Books. Coffee. Wine. Love.

  • Fernando Montes

    • Senior Software Engineer @ Nearsoft
    • ITESM - CEM
    • Code. Web. Videogames. Books. Coffee. Wine. Love

Agenda

  1. Intro
  2. The tools
  3. Setup
  4. Coding time
    • Create base site
    • Personalize!
  5. Publish to Github pages
  6. What is next?

Intro

  1. What are we going to do?
  2. What is the expectation?
  3. What is the motivation?

The tools

  1. Git
  2. Github
  3. Hugo
  4. Github Pages
  5. Markdown
  6. Any text editor

Setup / Prep

  1. Install Git (https://git-scm.com/downloads)
  2. Install Hugo (http://gohugo.io/overview/installing/)
  3. Create a Github Account!

Coding Time

Create base site

  1. Create a Github repository (e.g. my-profile-com-mx)
  2. git clone github_repository_url
  3. cd github_repository_folder
  4. hugo new site mysite
  5. cd mysite
  6. git clone https://github.com/gcushen/hugo-academic.git themes/academic
  7. cp -av themes/academic/exampleSite/* .
    • Copy the example site from themes/academic into current directory, this will give us our base site to work on.
  8. hugo server --watch
  9. Site must be accessible at this URL: http://localhost:1313/
  10. Commit and push your changes!

Personalize!

  1. Personalize your name (mysite/config.toml)
  2. Personalize your picture (mysite/static/img/portrait.jpg)
  3. Update personal data (mysite/config.toml)
    • e.g. [[params.social]]
  4. Update the sections you would like to include
    • [[menu.main]]
  5. Update the content of your site

Publish to Github Pages

  1. Modify mysite/config.toml file to add the lines that will allow your site to be published.
  2. Make sure all your latest changes are committed and pushed.
  3. Create a new repo where your site will be published (username.github.io)
  4. Clone that repo in a separate folder (different from my-profile-com-mx)
  5. cd my-profile-com-mx/mysite
  6. hugo -t "academic"
  7. cd ..
  8. mv mysite/public/* ../username.github.io/
  9. cd username.github.io
  10. git add -A
  11. git commit -m "Publish site"
  12. git push
  13. Go to to http://username.github.io to see your site live! :-)
  14. Repeat steps from 5 to 12 to update / re-publish your site.

What is next?

  • This is the start of a new path for you. Use your power wisely.
  • We recommend you to visit: https://gohugo.io/ to learn more about Hugo.
  • We used the Academic theme for the purposes of this workshop, go ahead and visit http://themes.gohugo.io/ to see more sites or even better, create your own theme!
  • Continue adding content, keep your site updated! Anything you learn, go ahead and publish it! You never know who will read it and find it useful!
  • Be Happy & keep learning new things :-)

References

Want know more about Nearsoft?

Contact us:

About

Build your personal site and blog using Hugo - http://gohugo.io/

academicbloghugo