 Hey, how's it going? Good. How are you? I'm good, and I'm very excited to kick off the Hotly anticipated by at least the two of us open publishing ecosystems flex course. Yes It's a long time coming. It feels amazing to be kicking off this This flex course finally. I mean, honestly, it's something that we've been talking about pretty much since I Started with reclaim back in June of 22 So being able to do it. I'm I'm so stoked Essentially, I came from a background of open publishing With the State University of New York system as an OER publishing coordinator so I I've worked in this space and I just have been wanting to revisit it a bit because When I worked in it, it was very there was a system and a procedure kind of preset for me and it worked for what we needed but you know moving into this space and interacting with the community that we have with these varied needs and varied resources they have access to and various things that we can provide and that kind of ability to explore has just really Escalated for me and so I wanted to take the opportunity to really like Look around at what is actually available in this space and to kind of Help people understand what true Open publishing could look like Yeah, you know, we're talking when planning this flex course about the idea of Both exploring tools, which is something we do a lot on video at reclaim I would say, you know, just kind of like what does this tool do? But also kind of exploring, you know sets of tools. That's that's the ecosystem part here, right? But even further than that exploring Really like the idea of how open can we make this whole process like start to finish, right? Not just Can we make a piece of content and make it, you know freely available? That's awesome, but Can we use free open source tools? that author things in a free open source Format that then publish to a free open source tool and then it's a free thing at the end of it, too Like how how far can we take this idea basically and is there value to that? Like what what what is there to gain by doing that, right? Which I mean, I don't know that there's like a definitive answer to that question, but we want to explore it That's kind of the point here is to talk about You know, yes, these tools exist Why might you do something in this way? What's there to gain from it? Yeah, and not a little bit beyond the tool Absolutely, and that's something that we're going to be exploring throughout this entire course, especially in the three weeks after this particular I mean this No, this this particular all of them are going to be addressing this and even even this one But we are in the next three weeks. We'll be talking with actual Experts in the tools Taylor and I are not experts in the tool we're going to tell you about today, but we do use it and But for the rest of them, there are other people who have developed the tools or have had a key role in development and You know the sharing of those tools and we we ask everyone that question of Like what why why would people use this and I think that I love that we have the opportunity to Like you're saying explore here and It's kind of it's fun. We get to play around and like you're saying to see how far we can push it and Really, I think there it's really cool to make a whole ecosystem of tools available when some people might only encounter one of these tools at a time ever and So being able to package them up and say here like here is a contextual list of Open source tools and what you might use them for and kind of give people the opportunity to Take what what works for them leave what doesn't maybe it's maybe it's a little bit of all of them Maybe it's one or maybe it's none and it's just still Valuable to know that there are other options then, you know, maybe what you're currently using Yeah, I think one of the strengths of Really every tool will feature throughout the entire flex course is Is that kind of mix and match? Possibility right of these can work great together or in some combination Or you can get value out of just one of them, but also they can live great as In different sizes of Projects and teams right so pretty much most some of the tools will feature are more geared towards an individual and some of them are more geared to towards a small team or a you know a Teacher-student kind of relationship or even an institutional repository type thing and that I you know that we're really trying not to Narrow down in terms of the flex course of like oh, this is the only good if you are interested in Publishing OERs at a school of a certain size like no We'll get some of the tools will feature will be really great for that Some of them will be better for a person who wants to write a thing and make it available And so that you know, we'll get into that with each tool Hedge-dock, which is kind of the first tool that we want to talk do we want to kind of get into that or yeah This particular tool I think can run the gamut it could be used by an individual person and it could be used by a group of people Equally well. Yeah, and that's kind of why we're starting here. So Hedge-dock is Something that we have been playing with for a little while here I'm not sure it actually when you started playing with it Taylor because I know that I had heard about it Right before I joined reclaim. I hadn't messed around with it, but I definitely heard about it So and then and then it was shortly after I joined that we started actually digging in and doing some stuff with it there was a session on The online portion of OER 22 And someone get I don't I should have had this ready But someone I believe at that conference had a session on Hedge-dock specifically and that's what made me aware of it Yes, which would have been right before you started reclaim. So I think that that Got passed around in my circles and that's how I heard about it So yeah, we should definitely look into that and we'll throw it in the discord chat when when we're talking and I So essentially what it is is I like to think of it as mark Google Docs for markdown It's a collaborative markdown editing platform where you can have multiple users collaboratively writing a markdown document It also is has live preview built into it so that you can be writing your markdown and then kind of either just look at the markdown or have kind of a split-screen view and immediately see what the Translated version of that would look like in a preview context Which can be really helpful for a variety of reasons And it also has, you know color coordinating all those nice formatting stylized elements of markdown so that you can you know the headings are different colors and Every everything is kind of color coordinated and so that's really nice when you're using something like markdown Which then kind of leads us to this idea of markdown I don't want to get too ahead of ourselves if we want to maybe show folks what hedge doc looks like first and what um what markdown Looks like in hedge doc and then um, we can kind of go into why This is so valuable to to us as users and also to kind of informing this larger flux course Yeah, yeah here. I'll pull my screen up really quick. Um, just show off the the hedge doc website here at hedge doc.org They Have you know kind of some of the things you just mentioned in terms of you know breakdown of what features are available and and stuff like that, but you know the the quick version of Of this the the the quick demo if they then in fact they have a a demo site You can actually look at which is cool Which we can just quickly log into here as a or make a guest note on Um, but this is the basics of what it looks like. It's a web editor. I can Type things over here and I can see how they're formatted over there so if I you know make something into a heading in the markdown style or if I Uh, this italics. Yeah um, I can you know format text in the markdown way. There's um a uh, wizzy wig Editor as well so I can highlight things and say that's strike through Um, or or whatever italics bold bold and italics Um, so that that's this is what the tool is and what it looks like But before we get too far into that do you want to talk a little bit about well, what it what markdown is first? Yeah, absolutely. So, um, I think that It's important for us to kind of take a step back and and talk about markdown mainly because that is the driving force for um a lot of this kind of open editing work And it's going to be brought up again and again in all of our sessions and we didn't come to hedge doc Simply because of hedge doc. I mean we just shared that we Heard about it or maybe encountered it at a conference and it seemed really useful But the reason it's useful to us and it was as attractive to us as it was is because it it is a markdown editor and um, I know that We both have our own experiences with getting introduced to markdown um And we both use markdown every day in our editing. Um, and what it is essentially is a um it's it's a stylistic type it's a type of Formatting text formatting. Um that When I first learned about it, they explained it as a riff on html But instead of markup language, you're marking it's a markdown language. So it's a lot simpler than html it's like html with all of the Kind of crazy stuff taken out and it's just very straightforward. You can make very simple stylistic choices with this language. Um And just using plain text and yeah yeah, um, you know the the um Whenever i'm explaining markdown to someone who's not heard of it. I actually go to there's a Page on daring fireball.net which is like an apple technology blog, but the person who writes their mark uh, but Groober right i think john groober mark mark groober markdown John groober, I believe kind of invented um markdown Or as at least but anyway He has a description of there and I always kind of go to this one of the first paragraphs in there Which is just it's two things. It's a plain text Formatting syntax. So it's an idea of how to format plain text And um, there are software tools around that. Um, he has one but there are many including headstock That can do things with that syntax. So, you know, can Make it look like something else or export it or import it and do very Many different things with it, but fundamentally it's the idea of writing in plain text um on a computer and Uh formatting it a certain way to provide you with formatting capabilities basically because right plain text would be Uh, you know just letters and symbols And I guess line breaks if you don't um have some kind of agreed upon syntax for formatting Yeah, and the syntax as we all know helps you make meaning helps you emphasize things and um So being able to do that in a really lightweight way Is really valuable. Um, and it's just kind of really low. Um learning far Uh barrier to entry very low, uh, because it's just a few symbols that are added on to plain text um, so you can understand it and a lot of um processing platforms can understand it and so When thinking about plain text And the reason why that's so important Is and and then this translates again into kind of markdown Um, which is just kind of the flavor of plain text that we're using um is mainly for us the portability of it and also the Kind of the standard of it as well um So just a brief story time When I was younger, um, I this is embarrassing, isn't it? But I did not know um that you could Write things on a computer in anything other than microsoft word um And this is a story that I I tell and something I admit about myself when talking to students um and People who need to understand today's students as well um because Especially when i'm trying to talk about like digital literacy and the idea of digital natives um where Yes, I'm seeing Taylor get excited because this is a topic we talk about a lot just one on one um And the idea that the younger generation Simply understands how computers work is so far afield like the younger generation if anything They're very good with interfaces and they're very good with The suite of tools that they are given and shown how to use and so I didn't grow up learning the way that the older generation did about Communicating with a computer when it was only the command line, you know, and that gives you like an understanding of computers and how they work um that you just can't get when you grow up In a world of word processors And so the way that I kind of go with this story is that I really thought I could only um Only type in microsoft word and I In sixth grade got really into typing because I had this novel This 300 page novel that I was very passionate about it was like my whole thing And all I ever wanted to do in my spare time was work on it I had no plan for it. By the way, this is just kind of like virginia wolf, you know free flowing, you know Just nonsense, but it was fun and so I Like I just wanted to have it with me all the time because I I never wanted to give up the opportunity Passed by the opportunity to work on it. And so I thought I was very smart I would bring around a little usb drive with my microsoft word documents on it and um Whenever I was around a computer that I would plug it in and see if they had word and see if I could work on it And then if they didn't I would be all upset Because I'm like, oh can't work on my book now um and When I think back on that time in my life, I think oh man, I really wish that I had known about plain text editing because I was so limited and so needlessly limited um In that time and I just I have all these vivid memories of of running up against that door um, so I I try to explain To students and you'd be surprised there are a lot of students who don't know what don't understand what a word processor is or the fact that something like microsoft word is Proprietary and it has a bunch of code that makes it look the way that it looks um And the difference or even like the idea of like document file model and like paths and stuff, right? Like there's no particular reason someone Like learning the how to use a computer for the first time today would really need to know about the idea of Files on a file system and what they look like, right? Like we're seeing we've kind of even kind of glazed over of like what plain text is But I don't know that I'm necessarily qualified to explain Like from a computer science standpoint the difference But you know that is to say like there is just text in this file, right? Like and a lot of things on a computer are like that You know not that aren't just notes and things right like your configurations on a computer might be plain text too, but um But like that concept is not a given necessarily that people would know that I'm certainly wasn't familiar with that Either for a very long time and I don't know that I have like as compelling of an actual anecdote But there definitely would have been a time for probably until maybe high school I would guess where I would have thought the same thing. It's like yeah, if you want to write something That's not an email. I guess Like I would need Microsoft Word, especially at that time like google docs wasn't really a thing for me until high school. So yeah yeah, absolutely, so That's you know that story I just used to highlight how important portability is a and just try to chip away at that notion of the myth of a digital native and How important it is to For people to know about being able to write in a platform agnostic way Yeah, yeah That brings us then to um To using it in hedge doc Yeah, well and and one one thing, you know, we we did The importance of plain text and and as an add-on to that markdown, right? Like there's a lot of different ways you could write markdown, but other than hedge doc too, right? You could You know, you could open up text edit on a mac or a notepad on a pc and start writing and save that as Any name and file extension really you want technically the file extension doesn't matter um or you know most of time we see that plain text as dot txt Or dot md is often Indicative of hey, this is a markdown formatted plain text file, but there's no technical difference, right? It's just a convention The tricky thing with markdown and learning markdown is you know When you do it like that in just a plain text editor You have to kind of know and memorize and you'll you will memorize the main things Pretty quickly because there's not like that much to know But uh, you have to kind of know and memorize the syntax. So like oh, here's how I make a heading Here's how I make something bold. That's two asterisks and italics is one asterisk And like as we kind of showed really quickly like Something that's aware of markdown like hedge doc can really speed that process up for you because you can You don't have to have everything memorized. There are other markdown editors, but the nature of plain text is that Most of them are local editors. So they're a program you install on your computer that will help you write markdown I've you've used many of them Like typora is one and obsidian. I think we both use for note taking and those are great tools But they're not really collaborative. They're designed for editing a file For the most part that just lives on your computer and where hedge doc really breaks this thing wide open is for for me is it is a Markdown editor that's pretty simple to use that is collaborative that you can have multiple people Editing at the same time from a server So it's not stored on your computer right so Let's um, let me get my screen back up and we will kind of Showcase what you can actually do with um hedge doc. So um This is our instance of hedge doc that we use at reclaim. It's at docs dot reclaim ed dot tech um Hedge doc is a self hostable tool. So you can run it on um, just about any type of uh Linux um server that runs docker um, we did a stream on making a uh One click installer and then last week we did a stream showing off that one click installer So you can run it really easily on reclaim cloud. I will also mention. I accidentally closed the Hedge doc documentation, of course, I have too many tabs open and Got too into closing things, but they have really good instructions on how to install it and they also have um Community page where they have different places that you can run it. So, you know, we Um, we run it of course on reclaim cloud and it's really really simple to use it there But there are other places. This isn't just a you know, um, this isn't a proprietary platform in any sense of the word um We're not going to talk today a lot about how to install it or like the technical system madman kind of stuff We did a stream on that like I said last week We're going to link that if you're curious about how to set it up yourself on reclaim cloud. It's quite easy We really want to focus on what the tool can do once you have it set up. Um, so I'll sign in really quick here and in our particular instance We have github sign in turned on So that's that works, um kind of seamlessly, but there are also um other There are other uh sign in methods and by default you can just make accounts based on email address. Um, so you can just give people accounts who should have accounts and Um, it's you know private in that way of only the people you give will have access right, um You do when you log in it doesn't have much uh in the way of organization basically Files have names and they can have tags and you can search through your entire All every file you've ever made in hedge doc that you still have um But there are not like, you know, uh heavy like folder kind of you know organizational elements It's really just a list of files basically um There is um, however a Whoops. Um, there is however, um, like I said tagging which I haven't gotten much into but um, I should Um, and I do love that you can search across everything. That's super good Um, so I'm gonna make a new note here So if I if I make a brand new note, this is what it's basically gonna look like for pretty much any hedge Doc instance including ours um There are three views in hedge doc. There is a This i'm gonna go right to left And basically there is this pencil view that lets me just write texts um Demo documents This lets me write some texts cool Um, and it's full screen this side by side view, which is I think really the thing on hedge doc This is the thing that I use almost all the time Um, and I think this is the cool feature of it, which is you can write text on the left and on the right side you can see Uh preview of what it will look like Honestly, I think that that is like the instant gratification of hedge doc for me Just knowing because it's like you don't need to see I mean this is you're literally looking at two views of the same content But it just motivates me for some reason when I'm writing in markdown to just see it being beautifully formatted on the other side I'm like, uh This is satisfying. It kind of depends for me to be honest like I I I would I use the side by side. Whoops. I use the side by side view most often definitely, but um, I Occasionally will find myself switching to just this just editor view if I Want to really encourage myself to not worry about formatting and just like no, I just need words on the page So I kind of like that I can have that option and it's just just click a button and I can flip back and forth Um, but I will say yeah most of the time I use this this particular view and then finally this one Which just shows the preview so it's not this is not an editing view at all You can't really edit much of anything from here. Um, one thing I do like about this um Sort of preview view is I like how clean and simple it is um, and I also really like Uh that you can Get like a basic table of contents over here. Um as well as links to Um different headings. So if I make another heading like uh, let's say heading two um, and I'll make Yet another heading two And a heading three um If I go to that preview mode again, you can see that it's automatically generated a basic table of contents over here. So um, if I was to do put something more useful here like um Hedge doc is a markdown editor All about markdown markdown is a plain text Yeah, um Hedge doc is a self hostable tool You can kind of see here that um Navigating this um becomes a lot easier because of this sort of dynamically generated Table of contents and obviously we have a small document here But if it's much longer, that's actually quite a big help and it's all linkable too So when I click on this little link icon, it actually will change the url so I can Uh Automatically link right into that if I want to show someone something I'm working on which is really kind of neat um There is of course, um all of these nice So markdown everything you can do in markdown you can do just from your keyboard because it's just symbols and text That's all markdown is But there is this uh toolbar that gives you shortcuts to all these things. This is super nice if you a just aren't a keyboard shortcut person um, and I think more importantly If you don't know Which is kind of where I find myself most of time I'm constantly forgetting How does markdown want me to format an image again because that's where this stuff gets a little bit complicated, right? Yeah So markdown doesn't only support plain uh just text you can embed images and um And links and things like that too. So, um, let's links so In markdown, um, basically you can have a Well, let's link to the reclaim ed tech website reclaim ed tech Um, I can in markdown if I know this already Put square brackets around this and then type a link in parentheses after that that is one way to do a link And that works great, but let's say you didn't know that um This helps uh, um hedge doc is going to help you with this a lot So you can just highlight a word and turn it into a link or you can even just um Sorry, I can highlight a phrase and then Click this link button And it's going to automatically start turning that into a link for me and do all of the Syntax for me and what I love about that too not to interrupt is that it just um It's kind of teaching you how it works as well Yeah, it's it's kind of beautiful because because it's markdown When you click a button you see exactly what happens, right over here It's like, oh, it just spit out some text and now I can edit it, right? Like it's it's Simultaneously making it easier and faster, but it's also teaching you so Um, I should have shown here too. If I just click this link button It's just going to spit out an empty link for me. So I can just go in here and say, uh, here's um Uh, let's go to the events calendar. How about that? And Reclaim hosting events The other kind of cool thing this is not so much a hedge doc thing, I guess but Markdown in general is the way markdown does links. It really encourages you to do links in a good accessible way where you write a actual title for your link instead of doing This where you just have a link on the page You can do that if you put a link on its own in markdown um, it does most editors will make that just a nice clickable link but Um, it's nicer better. It looks better. It's more accessible if you're using like a screen reader or all kinds of other tools To write an actual title and markdown makes that pretty simple. Um Yeah, I love that So that you know, sometimes I think what's great about the wizzy wig too is it teaches you makes it quick but also like sometimes when you're Just like you were saying earlier just writing just trying to get stuff out Um, you don't want to always have to click back in and then add in those symbols Manually in all the right places So like you gotta put the square bracket and the part of the sentence that needs to be Being able to just highlight and click the button so that you can just get You know go go back and add that format after is really convenient. Yeah, for sure um, so, uh Some of these we won't go through all but of course it's got bold italics strike through Headings, which literally will just you know make various sizes of headings or uh, You know in the the hierarchy of headings. Um code which, uh I actually have not used this particular one I think what what but what this will do is if you write code you can highlight it and it will Mark it as code the way markdown does so If I do this It's going to put it automatically put it in um the back ticks Um syntax so I can have it in a little code fence or whatever. So let's say it's You're talking about docker. Okay. There's my docker command. So, um That's what what the code button will do is if you highlight something it will turn it into that And uh make a code fence for you basically Um quotes, which is super nice too. Um, so if you're quoting something this is a cool quote Just makes it pop. Yeah me just now um You've got uh bulleted lists and I use bulleted lists and markdown all of the time personally, um And the nice thing about that is not only will this make a bulleted list But it will support like using the tab key to indent and shift tab to Outdent is that the word? Whatever reverse indent Well, let me also just point out too that you made a bulleted list without even kind of realizing that you did it earlier so like you can use A dash like that or you can use the asterix. Um, so there's a couple it's not super super strict It kind of gets gets what you're trying to do. Um Yeah, I think this is a good example of I think technically the markdown spec says it's an asterisk But I use a dash just because That's what I that's the convention for me And both hedge doc will let you do either one. So if I if I continue this bulleted list It's going to automatically be like, ah, yeah, here's another thing another bullet point And I can indent it further and that gets into the color coding you're talking about, right? So you can see here that because it marked this in blue. It's recognized like, ah, that's a bulleted list Yeah, and then it's also like you're saying doing that that additional formatting that happens when you when you press tab So going from the filled in bullet to the open one and all that kind of thing. So Yeah, um, so similarly, um, you can do numbered lists to um Oh and something else to point out about markdown too is that line breaks actually mean something So if you notice in that your quote section, you don't have um I mean obviously something but you need like like space um Because that is also going to determine how things look And that is one of the things that I trip on still to this day as you can see here I didn't actually mean for this to be like that But the reason that works that way is that is how html works, right? So in terms of It's it's it's trying to closely align mark markdown and html are kind of closely aligned And you don't have to use it or think about it this way, but everything that markdown can do is designed to be um Directly directly. Yeah, directly translatable to html. So that's where some of these like Writing conventions can be a little bit weird in markdown and that's where having a an editor that has preview is super nice because Left to my devices. I do single line breaks all the time And that's not actually how you're supposed to do it in markdown. So, right? Um There's checkboxes, which is kind of cool. Um, they're they're pretty simple but if I hit the checkbox button, it's just going to do a Unordered list with square brackets and if you put that in with an exit, it'll check it off. So yeah, I love those Yeah, and it's um I particularly like um Them uh in uh in Hedge doc because you can check them on the preview side and it will actually edit it over here, which is kind of nice um, so I love it. Um, yeah, so that's checkboxes. We already talked about links Uh images, um images is a big one the way markdown does images is you write a link to a image file And then you have a exclamation point that previews it So I'm going to do it the long way and then we're going to do it The hedge doc way in a second because there are a lot of things actually that hedge doc makes is simple, um because Images are kind of a sticking point for me with markdown editing. It's Usually a pain point so um because markdown is just plain text if I was Not using a fancy editor. I have no way to preview my what my images look like So if I go find an image on the internet like I'll go to the reclaim at that tech site here Really quick and if I just grab say Let's yeah, let's grab this link here. So link to this image. I open a new tab. Cool I can of course In my demo document I can just paste that in And then if I make it a link The markdown way um, you know, it'll it'll be a link a link to an Yeah, well, let's see. What is that? It's a tv that says splashing around install with install train apps Okay, so that's a link that would be great if I typed all the words correctly If I throw an exclamation point at the front of it, um It becomes an actual link in the document, which is super cool. So that's that's great The problem is what did I need to do that? Right? I needed A image already on the internet somewhere Um, and then I had to like paste it in and write that out one cool thing with markdown is this text I put in here that was the title of the link. This becomes alt text for the image, which is super nice. So You know, technically you can leave this empty and it will show up but um, again markdown kind of encouraged you like hey, you got an image there It's got a sad You know empty square brackets with nothing in it. You should put alt text there. So I really like that markdown is Because it's ties to html So closely It is kind of of the web and in in some ways encourages you to author content in a way that Is you know more accessible later on so Um, so that's great But it was a lot of steps honestly in this case. I already had an image Right. I didn't have to like upload it or anything But let's say you're writing doing something from scratch and you're like, I have a cool image Let's say I go to I don't know the this particular page here And I want to screenshot this website for a second. We're going to use this as our image My screenshot this on my computer And just save it to my desktop for for upload Now I have to go like put it in wordpress or maybe on Like my cPanel file manager somewhere accessible That's no good. Um, I mean, it's just it's a lot of steps. So Hedge doc actually simplifies this greatly and you can hit this little upload button And I can just pick this image from my desktop Hit open and it's going to automatically Insert it as an image and you'll see that it actually uploaded it to its own file storage So that this can be served up. So if I look here, there's my image I just have this is such a time saver if you've ever worked with markdown Images before this is huge honestly really big Um, and then I can go in here and put things on flicker like I used imager a lot for it, right? Um, and um, and then like obsidian was honestly a revelation for me with this For local notes because obsidian lets you just kind of drag or copy and paste images in And it will put them in the right place in its file structure Hedge doc does that but for public notes, which is huge and on the web So and then I can still go in here and write my description as I want So let's say I've got this gorgeous useful document that probably has all the words spelled correctly and I want to Have this be something that not just I can see Um, I suppose I'm I'm getting a little bit ahead of myself. There are other there are other things in markdown too. There's also uh in Hedge doc you you do have a table Uh thing which will just kind of spit out a table for you to work with um the line tool which just makes uh line on the page and comment which is kind of I haven't really used this one and I honestly I don't even I didn't even know markdown had an idea of comments I think this might be kind of a hedge doc convention honestly, but the idea here is you can have Comments and it basically just treats them as quotes in markdown. So um But uh, but it's nice Um, the table thing is also nice markdown tables are bad if you have to do a lot of things in tables um markdown's Concept of how you manage tables is really tricky because you have to like Man you like let's say I want a fourth column. I have to go in here and like do all of this Kind of breaks it temporarily and yeah, yeah Technically, you don't have to have like the same amount of stashes like that. It's flexible But if you don't then it looks weird and yeah, it's Hedge doc saves you some time. This isn't I'm gonna call this is not entirely hedge docs fault. Um, but they're Let's just say don't put your home budget in a markdown file probably like you're not gonna there's no calculation Or anything like that. It's it's a little annoying to do spreadsheet stuff here, but it's okay for basic basic tables um so I've got this document. I want to share it with someone and um There or maybe have someone help me edit it. So over here on the right side There is all of the permissions tools Um, I can confusingly from this very menu. I don't think this is the best option for this to be right here I can delete the note or I can share it with people Um, I can see how they got here, but I don't love that this button is there It's very easily accessible Yeah, it just feels like it should be in the menu menu Yeah, you know the menu called menu. Um, so um Right from here, I can choose a bunch of different Uh Permissions things. There's some short descriptions here of like okay private, which is what this is right now Only I the owner the person that created it can view it and edit it great Protective this is only the owner can edit but forbid guests and this is a really weird one You'll you'll as you go through these you're going to be a little bit Some of these make sense like anyone can edit some of them make sense only The owner can view it and edit it some of these are a little bit weird What I would highly recommend if you're Wondering about permission stuff in hedge doc is go back to the main hedge doc page Click on your account thing and go to features This will bring up a markdown file that just goes through all of hedge docs features And it actually has a fantastic little table that shows you what the different permissions levels are and what they can do Yeah, that is An absolute lifesaver for me because having to kind of critically read the options there It doesn't it's not can yeah, it's not it's not great I I reference this quite a bit when I am like worried about the permission like if I have a specific thing I want where it's like, okay I am okay with Amanda and myself being able to edit this But I don't want anyone to view it even or edit it other than like people that can sign into our instance That's when I start consulting this table. Basically. Um, I will say they are doing Really good work. Um, hedge doc the team of the open source contributors to hedge doc are doing really good work On a 2.0 that really greatly simplifies this and will kind of eliminate the need for this table in almost all cases I think Yeah, um, and we actually do briefly take a look at that in our stream More that we did on kind of the sys admin side of hedge doc but I'll also Mention if you're curious about where hedge doc is going they have a developer preview instance at hedge doc dev that you can check out This isn't available just yet But you know potentially soon they're on in an alpha version But basically they're doing some work to simplify this a little bit, but for right now This this this table is what I would recommend checking out So let's say I want to share this so that Amanda can sign in and and edit it And also anyone can View it anyone who has the link to it. Um, I would probably want this locked one Which would allow guests to read it but not write Um, oh, I guess I suppose I also want signed in right So let's that's what I want is actually editable. This is where the table comes in handy So this means owner me tailor can read and write Anyone signed in can read and write Guests can also read. So I'm going to change it to editable Oh, that's all I have to do now. I just need to grab this link and share it with Amanda And man, I'm going to put this in our slack really quick and Amanda's going to sign in and She'll be able to edit it So as soon as she logged in I got this little thing up here. It says hey changed. This is funny My computer time must be behind because it says you changed something a few seconds from now Which is weird, um, but if I refresh it says changed a few seconds ago But you can actually see this kind of little preview of these are the people who have done anything with the note And if I go here, um, make some changes, um, yeah Or get on it Say it's literally live preview here as Amanda makes changes. I can see them amazing So, um, that is the The the really cool thing about hedgehog is it is truly google docs level collaboration We can see people typing and editing things Um, you can I believe even see where cursors are. I'm not 100 sure about that one. Yeah, you can So on your side, you can see that I've got my cursor Yep. Yeah, so I can I can see Amanda's cursor jumping around which I may sound like a small thing. I think it's not when you have like more than Even one person on a document. It's good to know that everyone's about to type over the top of each other, right? Because that absolutely I have we all know and that happens in google docs. It happens in hedge doc too Yeah, so this is fantastic. We've been using um hedge doc at reclaim for various projects, um for Yeah, like about a year and a half or so And this collaboration stuff is For markdown anyway, second to none. I haven't seen anything that does it quite as good either pad can do some of this but, um, ether pad is not really a markdown optimized tool like hedge doc is where it can do Preview for hedge doc and all of these nice nice cities around it so yeah, and like I think a big thing is that If we wanted to move this somewhere else outside of hedge doc That's what we're going to do and the rest of this course is we're going to take this right here and we're going to move it and the only thing that's really moving is the What you see on the left, you know just it's we've got All of that is just text. We don't have to worry about it being you know super specific to hedge doc And then we can just move it somewhere else. Yeah so a couple other interface things here in hedge doc so um besides the collaboration features and everything there are a few other options under Up at the top here. So publish. This is really just going to Give me a way to look at that preview view without any of the original like interface around it And I can again share this link with anybody. So this link is um because I set this to be editable, which means If I look at our features document here, that means guests can read guests means someone who's not logged in at all right hedge doc This is publicly accessible. Um, which is super cool And the beyond publishing uh in the menu here. There are some other things you can check out revisions to the document Which is really interesting. So I can get a timeline here of how this has changed google docs also has a feature like this Um, and you can actually download the markdown Files of each of these so I can say yep, give me a copy of this one or I can revert it Or I can just copy right like I could just say like, oh, you know what I got rid of that link Let me copy that out hit cancel and just paste it in over here and bring it back into my doc That's super nice. Um the slide mode. We didn't do this. Um, but technically There are there is a there is a standard by which you can actually make presentation slides in markdown and this will Automatically preview them now ours is going to look awful because we didn't write it like slides But if I was to make a new document really quick and I won't do much with this but you just use separators so This is a slide another one And if I go to my slide mode Those are the slides. Oh, I think I actually I got this a little bit wrong You have to I think include Yeah, this is this is bumping up to my knowledge of markdown It so it looks like that first one is the title not not an actual slide But my point is if you're authoring slides in markdown, you can preview them and actually present from this which is super cool Um, something I want to learn about actually for for future presentations is to use Hedge doc as my slide editor too um This the rest of stuff though gets really powerful. So you can um in hedge doc You can enable gist Import and export. So gists are just single file github repositories basically um, so I can actually take this Demo document here and this is this is starting we're we're dipping our toes into publishing, right? So this isn't getting into um Hedge doc is mostly about editing, but we can do a little bit of publishing in hedge doc too. Um, I can actually export an entire Um document right out to my github account. So right here Instantly, I have this demo document dot md file, um All linked out including which is super cool like all of the images too. Um and uh You could if I'm github gist allow a secret or public note. So I could take this hit edit Hit make public And now this is a url that I could share with anyone. Um, which is super cool. Um separately though, I can also import Uh gists um from github. So if I go to my main thing here, let me grab This yeah, here's one. Um If I go to this I I do believe I'm I will need it to be public But if I take this markdown file And hit menu report Oh not a valid url. I think I have to um Maybe the raw url Actually now that I'm saying this I haven't used that feature before I'll have to I'll have to look at that a little bit more I haven't imported uh gist But this is probably just um one of those things where I'm not doing this quite correct Um, but you can theoretically import from github as well. The thing to know though about gist Is that they they themselves, right? Like if you've written in markdown I can also just copy this entire thing, right? I can copy the text of this and make a new document and paste it in And I have a complete copy of it. Yeah, especially because the images are also Uh public images already Now this is kind of a weird example because we made this one in hedgehog I exported it out to a gist like I don't know a while ago and now I pulled it back into hedgehog But you know this works the same for anything written in markdown, which is super cool that ability I can just copy it and paste it and it is the same is I think super powerful Um, so uh further than this we can also download things as markdown Files so that's really just going to export the plain text out. So if I open this now In my downloads folder is that file I'm just going to open this with with just a complete plain text editor. This is what the file is um, but if you have a Another editor that you like maybe like visual studio code or um I think I have a vs code window open already. Um, I don't want it to take me over there Um, because I've got a I use visual studio code for my blog. So it's I've got a blog post underway somewhere else on my computer Let me use Well, it's going to be public soon. I guess but hypora is a markdown editor that I've used before and So I can just instantly get this file right into that editor, which is super cool Um, another one I can do with this is export it as html and raw html So the difference here is raw html is going to literally just run the markdown conversion basically On from markdown to html. So this just this is just an html file There's really not much style information here. If I look at the source of this This is just html tags just simple html tags So that's cool. Um, and you know, you could you could keep that if you wanted it in that format But I think is even more interesting is this normal html one not the raw one This will do the same thing but make it look like that publish Um page does so if I open that file, I just exported In a browser it looks like this nice And the really cool thing with this is It's just an html file, right? So I can actually Upload this to like my c-panel if I wanted to and I have a basic One page like set a documentation or a site or instructions or something Well, that's like the power of markdown being directly translatable into html is you don't have to write all of this out in html I mean that's no one wants to do that. That's ridiculous, right? But so you can get this fully formatted html version just by writing some simple markdown Yeah, so it's it's it's super cool and I love that You know, it's as simple as that like here have a file. This could be a website, right? This one file could be a website um And if you go in here, it's kind of interesting from like a technical level because it is still basically like that really simple html tags, but then it includes all of this other style information on the page basically so It's all portable like all you need is this one particular file And even this is relatively editable, right? Like you could go in here and See like, oh, yeah, here's a list item and These are some links like if if you've looked at html before Nothing about this is super Um hard to parse basically. Yeah um, okay, so Going back to my demo documents Yeah, that's really that covers all of the the important export options that That's uh hedge doc offers But in in it doesn't do a lot, but the great in terms of other formats besides html and markdown But the great thing about markdown is again, there's a whole ecosystem of tools around it. So while we can You know go to github with um with hedge doc or download as a file Throughout the course of this The next few weeks we're going to do more things with our markdown files We do and we make in hedge doc and and non markdown files too. Some of the other tools we're going to cover Um can work with all kinds of different files, which is super cool but You know markdown being this plain text thing It it's just so easy to feed these files into other uh formats and and uh as you see fit basically Totally And that's what we're going to continue to do throughout the rest of this course. So I think that's a good overview of hedge doc And sets us up nicely going forward Yeah, um, so next week we're going to talk about uh manifold Um and really excited about that session and we don't need to go too much into it because we're already a little bit over time But I hope to see everyone next week to talk about manifold. Yeah. See you next week Bye