Get the quiz sheet for this module from the general Assessments page. Fill it in, then submit to the online grading system before the deadline.
Since this week is another week with a project submission deadline, I’m keeping the exercise short, but there is some cleanup and improvement I’d like you to do for your portfolio. Some of you might have already done some or all of that, then you can just ignore.
Make sure your portfolio repository is fully up-to-date and synced. Open the project in RStudio.
First, let’s make sure it’s easy for people to go from your portfolio
website (the github.io location) to your file repository
(the github.com location) and back. To that end, open the
_quarto.yml file. At the bottom, it says
URL-TO-THIS-REPOSITORY-HERE. Replace that with the URL to
your Github repository. As an example, for the MADA course, the URL one
would put in there is
https://github.com/andreashandel/MADAcourse (while the
website lives at
https://andreashandel.github.io/MADAcourse/).
Once you done that, when people now are on your website, they can
click on the Github icon in the top right corner and be
taken to your file repository. Try to make sure it works by rebuilding
your website and pushing to Github. It might take a minute or so and you
might need to hit refresh before it shows up on the website.
Now, let’s connect the two in reverse. Open Readme.md
and update the text. This is what people see when they come to your
github repository for your portfolio (as opposed to the website). I
recommend adding a little bit of text and a link pointing users to the
actual website. You can look at the
Readme.md for this course as example. Edit yours as you want.
You might also want to point to your website in the top right area of
your repository on Github.com. If you go to your repository on GitHub,
you should see an About section in the top right. If you
click on the gear symbol, there is a field in which you can enter the
URL for your website (the github.io location). It might
already show as pre-populated, but you have to actually manually enter
it before it will show. You can again see how that looks on the
repository for this course.
With this, it is easy for anyone (including yourself) to quickly switch between the website and the file repository.
In preparation for next week, make a copy of the
tidytuesday_exercise.qmd file, name it
tidytuesday_exercise2.qmd. Open it, delete everything apart
from the YAML header (the stuff between the ---). Add a
sentence that says “To be filled” or something like that. You will fill
it next week.
To see the new file and access it from the website, we also have to
include it in the website navigation bar. Open the
_quarto.yml file and add a menu entry called
Tidy Tuesday 2 Exercise and link it to
./tidytuesday_exercise2.html.
Make sure your website rebuilds ok. You should now see another menu
entry for Tidy Tuesday 2 in your Projects section and when
you click on it, the essentially empty file we created should show
up.
We’ve added most content of interest to the portfolio website. If you
have created other noteworthy products, either as part of this course or
outside, feel free to add them to your website. By now you should know
how to do that. For instance, if you want to add your project, either
now or once its done, feel free to do so. It probably doesn’t make sense
to put the whole project content inside the portfolio. Instead, take the
main product (e.g., the manuscript file), render it to
html, and add it to the website. Or create a new
project.qmd file where you briefly describe what you did
and show a few highlights, and then provide a link to your main project
repository for those interested in looking at the whole thing.
At this point, it might be worth revisiting your already posted pages and making sure everything looks as nice and professional as possible.
While the way we built the website has only limited ways of styling
things (unless you want to start changing CSS and HTML code), you can
still customize some. Feel free to play around and customize the look.
You can find a good bit of information in the Quarto documentation. Some
additional information (maybe slightly outdated since it’s Rmarkdown,
but most should still work) is
here. If you look into the repository for the MADA course, you will
also see that I’m using my own CSS file (called
MADAstyle.css). CSS lets you style websites. It’s not hard
to write CSS code, but it is its own thing. I usually just search online
to find what I’m looking for 😁. You certainly don’t have to, but if you
want to further customize the look of your website, you can add your own
CSS file and style it how you like.
Future employers really do look at portfolios like this, so being
able to showcase something nice and polished is useful. It is also part
of having a good online presence. I think for (future) professionals
like yourself, a solid online presence is vital. I discuss this with our
grad students in another class, if you want to see my thoughts on that,
you can check out this
presentation – which is of course made with R Markdown and posted to
a Quarto based website 😄.
I know where to find your portfolio, so you don’t need to submit anything. Just make sure you push a fully updated and re-built portfolio to Github and that the website looks right. I’ll take a look at the website after the deadline.
Submission of part 4 is due. Make sure your updated project is on Github.
No discussion assignment this week. Instead, submit project part 4.