from the ones that you've got during the whole week because during the whole week you've got a lot of materials from the lecturers most often on open on github and so on that you can usually you are able to install something you are able to to see the slides and so on and in short I have nothing prepared except those three pages that I wrote yesterday and

that's the stuff I will show you and discuss so it will be largely improvised but at the same time I welcome all the questions so if you have any questions just interrupt me

and I will try to answer the question as best as I can. The whole idea of the session is basically just give you a very very brief overview about this topic about how to share your knowledge with other people and I try to do that in

my work so I hope it will be useful for some of you so maybe as I mentioned I don't have a presentation for this session so maybe let's start making one why not sometimes it's probably it's usually it's better to have a presentation made before your talk but we can do something new so maybe I'll start a new RStudio session I don't even have a directory for that so

maybe that would be a good place to start oh and I am very well organized so I have a folder called conferences and then I can open a new folder which I will call AGH 2023

and that was that will be my new new project and I probably made that wrong I probably should do it this way that's how I roll okay so I will have a new fresh RStudio project

and then yeah let's let's start making slides so if I just add a new file you can see on the list there are some few things and I can for example create a quarter presentation and they ask me for the title of my talk I have very short memory so I don't remember the title of my talk gladly it's online so in the open so I can just copy and paste the

title of my talk so we have a title my talk I know my name that's good hopefully and let's create the template of the slides what else we can do I can also add a date just to remember

myself that's today is the 1st of September and there's a template but yeah I don't like it so let's remove it so let's maybe let's maybe start with a short introduction and

maybe just save the file for later and that's that's important and you'll see later why but I will call this file index.qmd and now just let's check if it works or not so just

let's render the the document and after a few seconds we have first title slide so yeah it's kind of nice five minutes in the talk and we already have the first slides and we partially even have the second one so who am I and again I can just go online and just

search for myself or just type the the address so basically my name.com and there is a you can see my face there and this is my website basically so probably it would be nice to

just add that to my slides that I can just use that in the future and now I just re-enter the slide and I have a slide with my URL probably I want to make this URL active so I will add those and yeah it's better and better so as you can see I'm an assistant professor at this university

at Adamis Kebec University I work in mostly G computation but I mostly apply the G computation also to environmental science but you can also see that I have some panels and there and probably we can start with the publications one because there's a book cover yeah there's a book cover

of the of the English of our book which was also written in the open so from the first sentence we wrote the book was written in the open but I'm also working on a few other projects and

in last year or maybe that was even early this year we rebranded ourselves slightly and we called the whole idea geo comp x like geo computation and the x is like a fill

letter that you can just put everywhere everything you want there and you can see that we have the the r book we have the python book we have the blog post and and few other things so so that's another website you can find some information and solve my work so let's add that to to my slide and of course you've seen that we have the the r book

we have the python book so why not just add them to the to the list the URLs are fairly easy to remember and let's render the slides so control shift k and then you see I have a something something like this so hopefully already you can see that

I have my website done in the open I have some resources materials you can also see that on my website I also have the presentation tab which is full of slides from my previous presentations

and workshops sometimes for videos I also have projects so in the projects tab I mostly list the software I make and the software the house for the software is usually github so if I click on this package you'll go to the github web page of the of the software and then you can jump into

this rabbit hole because then you can go to the website of the software and then from the website the software you can go to some vignettes and and then you can just try to read that and run the code etc etc etc so why I'm showing you this just to give you like a short introduction to the

whole idea of working in in the open most of my daily work is done in the open I'm not saying all but but most so so that's that's all about me but then we we maybe could also try to think about

very simple question and the question is why like why should we even share the stuff we do so you are you are do that the thing you are

writing the code you are writing the text you are you do the thinking so why should you even share share that so I thought about a few few ideas of that so so one idea is maybe just to give back

so you know that you you are learning you are developing yourself you are you are improving yourself and you are often I assume are using open materials so basically you can also give back to other people by sharing your work by sharing your ideas by sharing your software by

sharing your thoughts so that's that's probably I think one nice reason to to to share and work work in the open you know that's not the only one in the last few days there was a phrase

said many many many times and the phrase was open science so that's that's another idea that we we we can put our mind and ourselves in this like movement open science movement feel a feel

of ourselves as a part of this community in that movement but I prefer to do something different so I think the better thing is just to say that we are part of science working in the open is the part of science because the whole our goal is to create knowledge expand develop be better

understand more so that's science it's not it's not open science it's science but again those are some reasons I was able to think yesterday but there are some more

so another exam another thing I was I was able to to consider is basically to learn and I will even change the style of the slide because a few days ago on on twitter I've seen

something something like this I've noticed that's I'll be able to zoom that enough but yeah so you can see this is the retention rate of of learning of course like all of the science there are some controversies about the pyramid and probably it's not universal for everyone but hopefully you can see that regular lecture is very hard to remember everything but gladly

this is not a regular lecture it's a demonstration so now right now we are our attention slightly better but look at the bottom of the pyramid teaching others is the best way to learn

and and this this this idea of of teaching others as a way to learn is very very nice because because it's more about ourselves it's not about those huge ideas of science and to giving back

to others is much much more about ourselves so if we just want to do something for ourselves we can just we can just just do that so I just save the image from twitter and I just put that into the subfolder so I can just add that to my

slide so and yeah usually there are several ways to do that but I like the control over over that with with neater so I can just add the the figure then you can see I have it here maybe I would prefer to have it on the center of the slide

and you can see yeah my presentation is getting better and better so so

then I've thought about some other other possible reasons to share another was another one was fame and money but probably comparing compared to many other industries that's not exactly the case

free coffee yeah free coffee maybe but free coffee is not actually free so so if you are doing that to for fame maybe there's like a local fender if you do it for money

probably there are many many more things that you can do if you actually need more money um and and there is a there is a simple there's a last very simple thing I was I was able to to consider is this is just just to share stuff

like when we talk we just like regular our discussions during coffee breaks what are they they're just sharing our thoughts we are doing that like in totally in total oblivion that's the part of humans so why not why not do that in the open why not share the work

just to share it and don't care about anything else about fame money about open science about giving back about learning just sharing them so so that's that's that and okay so so now for the last uh uh 15 minutes you were able to see some

examples and and some ideas but um I also showed you at the start I also showed you my website because you know okay we were discussing that yeah let's let's work in the open so how to do

that how to make people think that we are developing available to other people one way is to have a website and I can give you even a nice example for this summer school because uh to

attend to the summer school you applied and many more people applied that we were able to accept and then when I was looking at the list I needed to find a way how to accept people and so on so on one of the things I've done at least for when I was like on a on an edge between like accepting

or not accepting was looking for looking people online and you know sometimes it was some of some of you are very visible you have your own websites you are you have your own github accounts you have your social media etc etc for some of you you have maybe a website on your

department website maybe you have a paper published and then for some of you there is nothing and it's and it's really really hard for in this case to know your work and learn about your work

and and expand upon your work if nobody can find it so that's why you can see this is this is a website and the same as I showed you um that's another one the website of composing of ideas around your computation with R with Python and so on and to to create such

a website you can see that's that's probably some work to to be done but it's not probably that this this work is actually not um that demanding so let's try to create a new website

so again just to um to do that so for the presentation I use the ideas maybe I should mention that before I should I use the ideas uh with the with the software called quarter so

if you haven't heard about that before it's but you have used uh to be a notebooks or R markdown basically idea of quarter is to have one set of ideas that you can use to create websites but also to create books presentations articles and many many other um things and it works

natively with Python R Julia and and some others so you can we can we can do a lot of a lot of things um so let's so I already had of course I already have the quarter installed and so on so if you are interested in that you of course need to start by doing that I think actually quarter is

is also installed automatically with newer versions of RStudio and then I can go to the terminal and in terminal I can type quarto um I think it's create yes and then I'll get a question should I create a project or extension so in this case I'm creating a project and then there's a

default website blog book and confluence so I want to create my own website so let's start with that and I need to specify what's the directory I will use so in this case I'll just go one directory up

and I'll just create the o h a o g h 2023 website and then some files were created and I have a new product so I'll go there

it's here so it will open shortly and then we'll be able to to try to maybe work with this website for a for a for a moment you can see that this website is

actually consists of just a few files so that's nice because you can start small and maybe that's in general important things to say important thing to say you don't need to start big start small have a just have a website and then you can think of how to add new stuff there

and you can see basically that the most important files we have a quarto yaml we have about qmd we have index qmd and styles so I'm definitely today not talking about css and so on that's not the place for that and the default style is okay so so let's really go to index that's the that's the most the most important and here you can see this render button and if I just clicked on the render

button after a few seconds I have a website so I can move that website to the browser to just show you the issue that website in the larger font but you can see I have the home and about

panels on the top and now I can just customize my website so for example I can change the title of my website so instead of having some kind of the path I can say like oh the best website in the whole room 21 yeah I need to be ambitious but not too ambitious

to know your limits and then we could we could add some text maybe we could add some maybe some some photos links and so on

so maybe I will add just link to the to the geocom x website why not and now if I go back to to this one you can see this is the best website in the whole world

and of course I can also play the same with the about file so in the about file I can mention that maybe this website was made during the open geo

farmers school 2023 and then you can see that we already have a simple website and of course the the only problem

of this website at the moment that I can think of is that it's our local host so this website only lives on on our computer so maybe maybe let's change that so I mentioned already more than once

the github web page or the github platform website and on github so I'm of course logged into github and this is how I look how I see my github page and and of course just to

let you know github is just one of the possible ways to do that there is another website called gitlab.com there they're also great and few others so it's up to you to decide and now I just need to create a new repository so I will create a new repository for for my website and I think it was

called so I have a new repository let's create this repository so basically what I've done here

I just created some empty space on the github platform and now I just need to move the website I made online so how can I do that I can just follow the instructions so look if I if I know how to do the quick setup I am almost done but there if if not I need to follow some other things

so if I go back to my to my website you can see there is no git folder without git folder it means that we cannot send it online so the option for us is more or less the second one so probably we

should start by initiating the and the git repository and then we could maybe for the simplicity I will just reopen this this R project because then probably we'll get the

new panel in RStudio so that will be easier for you to to follow but in general now we need to add the files that we will send online so you can see we have a new git panel and now I just want to

add all of those files so ctrl a I'm adding the files and then I'm saying just that this is the start of my website and then I need to just create a branch connect that branch to the online website

so the last three rows and then when I'm connected to my website I just need to do the push so basically I need to send the website online okay so now let's go back to github

f5 so my website now you can see it looks different because my website is on this repo so are we done almost now we just need to say uh to github that I want to publish the website

the web the web page so to do that we need to go to settings we need to go to pages and here there are some questions deploy from branch and then which branch so in our case we only have main branch and then we can select should we deploy from the root or docs so in our case

probably we need to change some settings because in our case we have site not docs and I probably should try to look at how to do that but in general this is how we work this is how we can can make it make it happen so why not let's let's go to the quarter website

and look for the for the answer so on the quarter website you'll be able to see many many things that are possible and I think that quarter documentation

has its pros and cons the pros is that you can read about everything that quarter can do and the cons are you can read about everything quarter can do it's a lot so you can see here

that we can you can read about how to publish different things and you can see that basically to change the output directory to docs we just need to to edit the quarter yaml file and as you've seen I've found that in 10 seconds and just to

underline that I'm still improvising I've never tested that before so let's go to choir to yaml you can see we've got this project website but you can change that the output directory to docs let's also change the title of the website

to to something more impressive and let's re-render our website so that it has the the most up-to-date version and now you can see we've got the new docs folder so we've got new docs

folder and docs folder contains all of the files of from our website so so I need to send my files online so they call that version two and now I will just click push so I will send the changes

on life all right so I think we are almost done with our website so let's go back to pages now you can see that here we have new folder called docs and so what's the what's the difference between our files here and the docs folder because the quarto and similar systems are basically

static websites what what does it mean it means that we write our website in quarto so we mark down and then when we click render it basically process everything into html so inside of the docs

folder you can see we've got index.html and few other files so now when I'm back in settings I can go to pages I can go to branch change none from to main and change roads route to docs and save so now what will happen it it it does that my new web website will be on this url

so it will be my main url class the the name of this repository

and it's not yet no site not found but don't worry I think it usually takes like a minute or two to to work and you you can even see this brown dot so this brown dot here means that it's still being rendered on and deployed online but I think that we should be able to to see it ready very very

short so in the meantime I will mention I want to show you some other things so I'm not going to jump into it but I will mention that this is a very simple website

and so in this in this website it's it's very very easy it's just about sharing your work so basically we have those two panels um home and about and then maybe I also want to add new panel

so how can I add a new panel to add a new panel I basically just need to add a new new file and maybe that's my new panel is a list of my publications so my public publications and then I could list some paper there and so on and I will call this file pubs

qmd and now I need to do one more thing in quarter yaml the quarter yaml is to the general file that you can customize to change the your website so you can see that there is an

nav bar navigation bar on the left and it contains the index and about so what I can do I can maybe just add my pubs qmd here and now I can just re-render the whole website

and I'll again show you show the website in the in the browser and now you can see there's the pub qmd uh yeah probably there's a typo I think I should have made pubs that's that's exactly right and again re-render let's go to the browser and now you can see there is my publication

sub website and you can list your publications or list your software list your presentation of the conferences and I don't know the photos of the stuff you needed or or your soccer team

whatever so that's that's how it works so let's maybe try our website once more and it's online so now you can see this is not I know it's hard to see from from the uh the the last rows but

basically it's online it's not on the local host and you can see this is the older version I haven't pushed the new changes yet but it works so hopefully uh you can see that this is a very low hanging fruit at least the the core because of course then you can spend days and and weeks

and months just improving the style of your website and testing 29 best fonts ever and and just changing the color slightly to make it better for you and then of course you can

buy 25 different domains and and and so on and so on but the whole idea is to start small so just start small just start with that and then you can expand improve and so on and so on so

okay so I have a website so when I have a website and I'm actually giving a summer school talk so so let's have a slide I have a website this is the url of my website

so I'm actually very very proud it's 35 minutes in and we have several slides and a website so let's just look at my notes because I have some notes and of course I I'm forgetting stuff so it's good to have notes um so this website uh we can compare this website for example to the

the ones I showed you before for example my home website and one of the differences is that there is a post panels in my outline so there is like a different blog post I wrote I wrote um and the same for the geocomx website we have different blog posts and um this is the

stuff I find kind of a strange in quarto um so I don't know if I'm doing that the most optimal way but I will show you how I how you can create your own um blog post place because in quarter when you

click quarter create and then project you can create either website or blog and those are two different things so if you if you just do blog and I will just put that into a directory called temp you'll see that you will see why in a second um so now

now I should have yeah this is that this is the new quarto quarto post it also again a few files but the most important is here so we have a new folder called posts and but if now if we

just open the index it looks slightly different it has like listings and so on and so on so what I usually do I just rename the index into something like blog and then I just copy those two folders so blog and posts and then I will just paste that

into my website folder and you will hopefully you'll be able to see why in a second so now I have a new file called posts which sorry called blog QMD which is here and it basically

says that that the content so the stuff I will I will create will be in the posts folder so here and there are some other um settings like what how the list of blog posts

will look alike and so on and so on again you can spend weeks customizing those and when you go to the post folder you will see actually two posts already written so you can just edit them and customize them there is also some metadata that you can also play with but

again maybe that's too much for us so just let's start by rendering our website and looking at how it looks right now huh our website looks exactly the same do you know what I what what I'm missing right now

clearing the yaml yeah exactly I need to edit the yaml I need to add I can I need to add my um my new QMD so my new QMD is blog QMD to the yaml and now again index here I render that

I go to my web browser and now look I have the post panel and now if I click here I have those previously made posts that the the template one and you can again delete them or

reread them or change them customize them and so on and so on so you can become very old school you can become a blogger it could be still 2006 or something um I I've still assumed that all

of you were born before that so so yeah so this is this is how we can expand improve and make our website website better um okay so let's so I'm I'm actually a very proud owner of the website

so I will just update again my website online so um I will add a note that I added block to my website and then now if I when I push that after again after another minute my website online would be updated so I don't need to worry about

anything more so um hopefully in a in a minute or two I'll be able just to refresh this and then it will contain all of my new panels and so on and so on okay so so I've shown you this I've showed you that you can create all of you can create

our website um so that's I think sharing working in the open because you know you are the experts you are working with different ideas different fields different tools so you should you should you should have the content I'm only giving you the tools on how to share the uh share that in

the open and it's 40 past 11 so probably that's too early for a lunch so let's let's try another idea um so I mentioned that um we probably more than once that we've got this geocomp x

website and geocomp x website contains links to two books we are either developing or finishing the second edition or working on the first edition uh the slide there is a slight difference between the technologies they use because uh two quotations of are uh here um it uses uh armardom

and uh and book down while in the geocomp through of python we move to the quarter system so this book uh again work in progress but still I can go to different chapters you can read those chapters

you can look at the maps you can zoom in on some interactive maps and so on you can see them some tables different styles subheadings etc etc etc

okay so we have a lot of time so let's write a book you know like I don't like to waste my time so let's do that so again let's go back um we can again click quarter create project and now instead of website or blog we can go to book

so it asks me to specify directory again I will do the ogh book and then it created some template for a book so let's let's open this project in a new session

but that's the one that you use for your book also and for that you can touch with python yeah

that's that's how we roll not yet maybe maybe in the future for the third edition or fourth edition sixth edition we'll see or maybe it was us like because you just use the book down yeah in in in execution yes maybe say what's the difference

down yeah so the R markdown the the the main difference between R markdown quarto is basically that R markdown as the name says is R oriented so everything you do in R markdown goes through R in some way you can you can still write python books in R markdown but it will go

through R for the rendering and so on and so on and the idea of quarto one of the ideas of quarto is to be language agnostic or to allow different languages but the other idea of quarto I think probably it for me it's more more important is that R markdown and the ideas around R markdown

were like being developed and improved and expanded but as as almost everything there was some chaos inside so there are different things like if you want to create a presentation it's slightly different from creating a website from creating a book and quarto tries to systematize everything so tries to give you the same tool so if you understand how to make a

book or website or slides with one then you should be also able to be doing something something different okay so let's let's let's write a book as I said so now again just a few

files as you can see here the most probably the most important at first to just look at and get the gist of is the again quarto yaml so quarto yaml is is our settings settings of our website so here I can specify the title of my book maybe I will call it the quickest book ever

and then I will specify my name and then yeah maybe somebody yeah because I typed the quickest and then maybe somebody's

also like trying to be quicker than me so I'll be the second quickest maybe I'll maybe I'll just add that you never know with a group of people like this and then and then again we've got the index qmd

and if we render that you will see that it will render all of the sub pages and again at the end we will have html version of the book so it took me three minutes and I have an online book it's not online book actually

because it's not online yet but I showed you how to push the website online and it works exactly the same and you can see that it's there is a title of the book there is my name there is a current date we have a table of content we have some text we can go to other chapters

and so on and so on so on okay so so let's maybe improve that book a little bit so maybe I'll make this sentence more round and then

I thought for for for a moment what should I show you during this uh this session and what what can I bring to to you and uh there are some developments in in spatial world so maybe I'll

show you some some of those that they that haven't been mentioned during this week or maybe just were mentioned uh very very briefly um so currently we are working as I mentioned we are working on the uh second edition of the competition with our we are almost done which means that we have some polishing to do which means we are not done uh but one of the

things that we pushed very very recently uh in the competition of our book is the making maps with our chapter so making maps with our chapter is about making maps so far yes I think it's a

good chapter title um very descriptive uh and and for this chapter and actually for the whole book we moved to a package that is still being developed or the version of the package is

to be developed and the package was mentioned by Lorena this morning called tmap so the tmap is a package to formatting maps in our um and the package was created first I think nine years ago or so but now there are some major changes going on with this package regarding both internals of

the package to make it easier for people to develop new ideas and add new visualization styles but also it changes the syntax of how the how to create maps with tmap maybe I should also mention that it should be more or less backup complete compatible so if you are already using

tmap you should be fine without any changes more or less but this is still version in the development so the whole this whole chapter and actually the whole uh book to finish with r so even if I go to chapter number six and in chapter number six is a raster vector interactions all of

the maps are also done with tmap version 4 so I thought yeah so we we are here so let's write a book about tmap version 4

so what what do we need to do that um probably we should start by maybe attaching some packages so you know in r we probably should have a or sf package or terra package that would be nice we could also it would be nice to have some example data sets

for those of you who haven't tried that you probably probably also should start by installing actually the tmap version 4 so it's on the github branch so it's r tmap slash tmap at v4

I should have the most current version so I cannot install it but that's for you and now I will just say that if I'm going to render the website I don't want to

install this package again and again so I just added information evil equals fall false which will mean that don't calculate this culture and then of course probably I should also add the tmap version 4 here and you have message for roger that's nice

so now let's let's maybe play with uh with with tmap for a second so uh with s inside of sp data

package we have some example data sets and probably one of the the the favorite ones that we are using is a data set called nz which stands for new zealand and

probably I still yeah I haven't done that and now we have them up so the tmap package works in this fashion that we need to most of the times we need

to start with tm shape and shape here means any spatial object so it could be vector data but it could be raster data and then we need to specify how we want this data set to be presented so here we say let's present this data set as polygons but we could also do that

oh let's let's present those because those are 16 regions in new zealand so let's present those as symbols or maybe we present them as borders

so tm shape is about what we want to show and then there are different functions to say how we want to present that all right so maybe let's go back to the general idea not the map and we render our book so now I'm rendering the book I move to the web browser and you can see

the chapter title changed so now it's team up version 4 if I click on the on this tab hopefully you'll see in a second what we what we have here so this is this is the basic

basic idea how it works and you can see we have our code we have some messages and then we have code again and some maps and of course we can play with those so for example

if I don't like the messages I can try to make the do something with it I can do like message false but I think it also

I think it's it's maybe not for the roger messages but it's not important right now so hopefully now you see that we can do that we can share those ideas oh it was

very very nicely so now you can see that if I refresh oh it's even automatically refresh now we can we have it and now what I can do I can because I have contracts so now I can write the book so I can say like let's let's start by installing team up and I will maybe

bold the team up team up version 4 then attach some packages and I will be maybe playing with the word so it'll be so ellipsis and create our first

and again uh control shift okay uh re-render and you'll see hopefully in a second that

we have a new version of our chapter with some text so now it's not only about code chunks but we have some text code chunk text and so on so on so but you know when in with with scientific publishing there is this uh this idea that

each figure should be referenced and should have captions so probably we should also do that here so what what can we do we can just add some options here so for example I can just say that

label of this figure is fig map one and then we can also add a fig cap so our caption and I will call it my first map let's again let's re-render that

and you can see that you have a figure number automatic figure number and we have

caption below our figure and what's really important is that now we can reference our figure so now I can just use brackets and add and say fig map one I'm now re-rendering once more so this

is the previous version create our first map exclamation mark but now after the re-rendering you will hopefully see slight change there is a figure one dot one I don't know exactly why we don't have

but like that but doesn't matter the whole idea applies um okay so and what else we can do I saw I showed you that we can bold things like because that's a markdown I can use um this double stars for bolding I can use single stars for italics

but I can also do subheadings so I can do like intro subheading and then the subheadings are very important in my opinion because they serve several roles one of the subheading is just to organize your work easier because it's easier for you to search

for things but the other important thing about subheadings is that then you can see them in the table of of contents you can see that here on the right and also you can leave the subheadings

and also you can link to them so for example you create some online materials and you have like three thousand pages but you only want to show people something you've done on page 500 then you just send them the link to this subsection you've made yeah

you can also see a preview of how it looks because now you have to run it over time and do well yeah I think there is a way that it could automatically re-render when you save the file but the rendering part is is always there okay because thanks yeah it takes quite quite quite a while I've seen uh I've seen a message from

uh the the deposit team that they know that quarto is not as fast as it's supposed to be so yeah that is the plan for the next year to improve the the performance okay so now we have we have though this this subheading and what we can also do with subheadings

um just let me find it we can uh name them and name them by naming them I can I say that we can basically reference to them so to reference them we just need to um say sec like section and then that's the name of the section like section

intro and then we can do a new section like my second map and as men mentioned in sec intro we are going to make some props and now let's render that

of course this is the the example I'm showing you right now but usually I won't work like that

usually I want to render everything every other sentence usually I'll just work and at the end of my working session then maybe I would render or usually I'll just put that online and it will be rendered online but of course at first it's nice just to understand how it works so you can see

now on the website you can see there is a reference and now if I click on that I will go to this one and if I have 78 chapters I can still click on that and it will move me and show me the the other location there okay but I think I will I need to stop a little

bit talking about quarter because I need to write a book about tmap so let's go back to that um so I showed you how to create a very simple map so let's create a slightly more complex map with in our new new zealand data looks like this so in our new zealand data this is a multi-polygon data

with 16 multi-polygons and we have several columns so we have columns like name island land area population median income and so on and so on so maybe I want to create a map of median income in new zealand so how can I do that so to do that I'm just using the same ideas so I'm basically creating

a polygon so tm polygons but now I say fill the polygons with the value of median income and that's

Now, automatically, we will get some colors, we will get a legend. Those of you who used Tmap previously, there are some new defaults. For example, legend, it's outside of the map frame. And also, I think maybe that's a good moment. As Lorena mentioned today,

we can change the map mode from the default plot to view, and we could have an interactive map. So I can just look at my Zealand, I can turn it on, off, I can change the base maps and so on and so on. But this is just a side note to let you know.

Okay, so we have our New Zealand polygons, but you know, we might want to improve our map somehow. So let's look at my list of what I thought is useful to do.

So let's maybe improve that by changing the scale. So here we can see we've got the scale. This scale, the color scale, is called pretty because it tries to give us pretty separations

between values. So they'll be kind of round ones. So here we have like 22,000 to 24 and so on and so on. But there are different ways to do that. And how it works with Tmap is basically, we can go to the documentation to show you that with version four, we have fill,

then we have fill.scale, fill.legend and fill.free. And those three are the most important. So fill is only about what is the variable we want to show. And then fill.scale is about how the color scale

in this case will look like. So here what we can do is fill.scale equals to tmScale. And then if you do that, you will see several options in RStudio. So for example, we can change the color scale

from the default discrete with pretty breaks to continuous, for example. So now let's rerun the code and you can see that the previous one looked like this. And now we have a continuous color scale. Maybe I'm not the fan of this color scale, so the colors.

So there is a values argument and I can change that to the spectral color palette. And then I have something there.

Maybe also that's not the best one. Let me just stay with you this. Next, I would like to improve the legend. So what I can do, how can I do that? Fill.legend, tmLegend, and then I can just change title.

And I can say medianIncomeUSD2007. I'm guessing it's probably not something, not true, but just to give you the idea. And maybe I can just create a new line

to make it more concise. And maybe it would be better to have a legend that is with a different orientation, because by default we have this legend that is,

that is like a portrait and we can do a horizontal one. So we can basically play with those different options and to update the style of my RMM. But let's go to what else can we do here? So we've got our legend, we've got our colors,

we've got our data, and now we can just add some map elements. So for example, we can do, we can add tmGraticules. So tmGraticules is just those Graticule lines.

So to orient ourselves, to give context to our audience. Then maybe we can also do tmCompass, which is just a North arrow. And if you look at the documentation, you will see that we, again, have several arguments.

And one of those arguments is position. So we can specify the position. And the position we could do just, let's say, left top. And we just move the North arrow to the left top of the screen.

What else can we do? We can add the scale bar. So tmScaleBar. And again, it will be automatically calculated, automatically added. We can also do tmTitle.

So tmTitle is the main title of our map. So I would make my audience impressed. And there is also tmCredits. tmCredits is nice when you want to maybe add the name

of the authors or mention data sources or mention the projection and so on. So I will just specify that this is the OpenGL Hub Summer School 2020. And you will see that it just automatically added, but I can ask all of the things. I can just move them with the position argument.

So they could be all over the place. It could be in different locations. It could be moved and so on and so on and so on. All right, so now hopefully you get the main gist

of the, of TeamUp version four. So let's maybe re-render the book. But in the meantime, in the meantime, you can also hopefully get the idea that writing such a book is just connecting different things.

So it's about writing the text, adding code chunk, then maybe adding some settings to the code chunk. But often writing a book and also the other scientific outputs is not only about writing for the audience,

but also writing for your collaborators and co-authors. So often when we work, we communicate with comments. So for example, usually what I do, I will just add my initials and I would say like, oh, this map is bad.

We need to change, maybe we need to improve the title. And then I will just, I will just hide it as an HTML comment. So now this is HTML comment. And now when I, when I'm rendering the,

rendering the book, this comment will be invisible for the readers. So if you don't believe me that I'm not doing those, just go to the source code of JKP-R and you will see a lot of comments.

But you can see now, oh, there's nothing below the map, but this is internal stuff. And of course it's easy to find because just search for my initials, it's not very often that JNN will happen in the same sentence. So that's how we can, you can collaborate,

you can contact with your collaborators. I showed you here that we can create maps and figures and, but of course that could be more things.

We can, for example, create tables or other things. So I could just create a new code chunk and I can just create a data frame and the data frame will be very easy because it will be a data frame comparing TMAP version four and TMAP version three.

So it will have two columns version. So the column version will be either three or four and description. The description will be good and better.

So we have a search data frame and now we can just use the very simple thing, just a cable function from the niche package. We can again render our new chapter.

And now after a few moments, you can see that we've got a type table in our book. So, and probably if I go to the browser,

you can see here it's here. So you have a table comparing very, very detailed comparison between version three and four. But of course, why people should see this? That's not important for the audience. So let's hide that, eco equals to false.

We can also add the label, in this case, TBL table one, and we can add the caption, probably TBL cap. So the caption will be a comparison

between TMAP v3 and v4. And let's render the book one more time. So now you can see that the code chunk is gone,

but instead of the code chunk, we have the title or the caption of the table. So that's nice. And when you do the work like this, do your scientific work,

we often scoot, cite and reference other people work because most of the time we don't work in total isolation from other people work. Like I think all of us here, we know what we know because of other's people work.

And for that purpose, let's go for a second to Quoto YAML. And in Quoto YAML, you can see this bibliography setting that it goes to the reference.bib. So this is a bibtech file, which is here.

And it's very simple. It contains just one note about the notebook called literate programming, but you can either connect to your own library of like Zotero and so on, or just add the bib representations here. And there are several other things, but basically it also contains a key to this reference.

So now when you sign my book, I will add, add note 84, so this key. This will be a reference to,

now let's render that. And now if you look, you can see this is, this will be a reference to note.

And what's I think very nice is that if you just go with your mouse, it will show you the reference. So you don't even need to know to go to the references. I don't know about you, but I usually say that. When I need to click, then I go to the references. I need to go back and I forgot what I was checking.

And then, yeah, I'm like going for a new cup of coffee. And automatically it will be also added to the references list. So maybe just a few closing ideas about books and quarter books. You can see also we can render to different formats.

So by default, we are rendering to HTML, but you can also render to PDFs and few others. And you can customize that as well. Another idea that I should mention is that with RStudio, you've got also something which is called visual editor. So it's here, you can click here

and then you can edit that more like a word file. I can use that, but it's possible. You can also add equations. You can also use many different languages. So I only showed R here, but different languages are also possible. Okay, so here you've seen the book.

I've rendered the book. The book is great. I probably should send that to some publisher, but in the meantime, in the meantime, I'm going to publish this book. So again, we can do exactly the same, what we've done previously.

So I will start by creating a new repo. So this will be my new repo called ogh-2033-book. I will create a repository

and then I'll just make sure that the git is there. And then we will send the changes to git.

So you can see those are the files we created. They're in the book folder. So probably we should also do the same thing we've done previously. So we should change the YAML

and we can check how we've done that before. So before we change that to output-dear-docs. So let's try that here as well. We probably should re-render the book one more time and then we will be able to push the book to GitHub.

Okay, so it looks like it works. I think it's slightly messy, but I don't care.

And then I just need to add a few comments. And then again, the book, the source code of the book will be on GitHub. So now let's go back to the GitHub repository,

F5 I refreshed, it's here. So I can go to settings, again, pages, branch, change to main and change those. And hopefully again, after a minute or two,

we'll have a book online. And not only we'll have a book online, but we will have all of the source code of the book online. So we can ask people, do you have some comments? Maybe do you have some suggestions?

Maybe there's some typo there. Maybe you can add something new to the book and they could just copy the stuff here. They can fork the repository. They can add the changes and propose them to be incorporated in this book. So this is how it worked. It's not only about one person sharing their stuff

in the open, it's about a lot of people also collaborating and working because think about it. If you are reading a book and you like the content, you like the ideas, but every other sentence, there is a typo. And you know, English is not my native language.

I barely managed to write in English. So for sure there are some typos. But if you don't like typos, after a few sentences, you'll be just tired. But if you fix them, they'll be fixed for all of the readers. So basically by fixing your own problem,

you will also fix the problem for many other people. So let's look if, yeah, in a sense, of course, yeah. So now we can see that the book is online. The book is online. It's not on my local repository is actually online. Oh, so I have a book online. So maybe I can add that to my presentation.

Yay. So, and I have a book. I have a book. So let's add it. Okay, it's 10 minutes to the end.

So probably I should do some closing remarks. Closing remarks. So now, yeah. So maybe let's quickly look at that.

So yeah, it looks okay. So now you've seen that we've got this book and we've got this presentation. So what should we do with this presentation?

Maybe just share that presentation online. So let's go to GitHub. Create a new repository.

So this one will be called the same as my project. So ogh-2023, create, and then I already have the git here.

So I'll just need to add all of the files. I need to commit them. And then I need to just run those three lines

of git commands to push it online. And now I can go to the GitHub again. I can refresh the website. You can see the source code of the slides are here but when I rendered the slides, they became HTML. And hopefully you remember that, but more than an hour ago

I said that let's call this file index HTML. Why? Because that's how browsers work. They look for the index file. So that's why we use our index QMD. And now let's go to settings, to pages, branch, main.

And now that we are in the root directory, so just save. So again, I can go to about and automatically add the website. And it should take us,

it should take us again a minute or two. And then we hopefully will have the slides online. So let's just, let's just wait a second.

And then that will be done. So in the meantime, maybe I can tell you a little bit more about how to start. So how can you start? Just install quarter, create a GitHub account or GitLab account or some other account, look at your work.

What you can share with others and then create a website. Actually, you don't even need to have anything to create a website. You are alive. That's enough to create a website. And then you maybe create, maybe you can create a book

or you may be like me and you maybe need to give a talk in front of a lot of people and you can create a presentation and you can just look at this presentation and think, oh yeah, now we have a presentation sharing your geospatial knowledge in the open.

And it's about me, of course, because I'm the author of this talk and we discuss why this is important to share. There are different reasons. And then we discovered that we have a website that works, it's online. And we also have a book that we can share, we can enjoy.

And we learned a little bit of team up version four as well. So my final message to you is just share. And just to close, because again, I have some notes and I forgot about them. Very important note that I wrote yesterday is copy others.

And by that, I mean, when people are working in the open, you can just look at their repos. Look at the Guild, Computation of Iron, Computation of Python repo or some other repos and just use that, be inspired, copy that. This is the working in the open as well, that you don't need to build everything from the scratch.

You can just use what people before you learn to use and then you can add your own new thing on top of that. Maybe you'll have some new ideas. Maybe somebody will then look at your work and be inspired and use it. Hopefully for the greater good.

So that's all what I wanted to show you. And I'm very happy that in this hour and a half, we're able to create a website, book and some presentation. Thank you.