----BEGIN CLASS---- [13:30] #startclass [13:30] Devesh Verma [13:30] pooja kumari singh [13:30] Any session today ? [13:30] Sourabh Pruthi [13:30] Abdul Raheem [13:30] Ratan Kulshreshtha [13:30] Jagannathan Tiruvallur Eachambadi [13:30] Karan Pratap [13:30] Rishikesh Bamdale [13:30] tabrez khan [13:30] No Roll Call announced yet. [13:30] ABD session is started [13:30] Shivam Bansal [13:30] Sorry posted before roll call [13:30] Vishal Kushwaha [13:31] storymode7, hehe [13:31] Deep [13:31] avik, not things, thinks [13:31] kushal, yes! :D [13:31] I will skip roll call today [13:31] Prabhu Sharan Singh [13:31] Gajendra Saraswat [13:31] Pragyat Singh Rana [13:32] AdityaPatil, yup [13:32] Hence proves people do not read :) [13:32] AdityaPatil, kushal :P [13:32] kushal, hehehehe [13:32] next [13:32] Now, any questions on RST? [13:32] No [13:33] ! [13:33] next [13:33] difference betwee rst and markdown [13:33] sourabh1031, you will have to learn both to figure out, it is like asking difference between C and C++ [13:34] Any other question? [13:34] kushal, nope. [13:34] Roll call: sulakhe pooja [13:34] ! [13:34] next [13:34] ! [13:34] is there a way to have TeX formulas in RST? [13:35] j605, yes, we will get to that later. [13:35] Roll call: Umesh Sharnagat [13:35] next [13:35] Learning one should be enough? (rst and markdown?) [13:35] kushal but there is a difference between c and c++ but both are good at their place is this similar case with md and rst? [13:35] sourabh1031, Yup [13:36] kushal thanks [13:36] sourabh1031, For example, I use Markdown for my blog posts, and RST for all the technical documentation. [13:36] Roll Call: Ananyo Maiti [13:37] avik, you will have to learn both, not that difficult. [13:37] avik, I sometimes type markdown in the rst files. [13:37] Always remember, everyone does mistakes [13:37] next [13:37] Who all do not know about Markdown? [13:37] say me here [13:37] me [13:37] kushal, ok! yes, they are quite intuitive! ok. [13:38] me [13:38] not me [13:38] me [13:38] me [13:38] me [13:38] Not me [13:38] not used for quite a while [13:38] not me [13:38] I said who does not know? [13:38] me [13:38] me [13:38] Me [13:38] no [13:39] me sorry [13:39] sorry [13:39] not me [13:39] Me [13:39] me [13:40] https://daringfireball.net/projects/markdown/ is the place to read. [13:40] Have a look at the basics and the syntax [13:40] you can install the markdown tool by using dnf or apt. [13:40] Start reading, and ask questions here (!). [13:42] ! [13:42] next [13:43] kushal is there any editor which supports md in offline mode [13:43] you don't need internet for markdown [13:43] it is offline [13:44] sourabh_1031, as j605 said. [13:44] sourabh_1031, do you want a preview while you are typing? [13:44] There are plugins/extensions for that, in all the major IDEs. [13:44] kushal yes [13:44] vscode or atom [13:44] j605 , kushal okay thanks [13:45] sourabh_1031, Generally markdown is so simple that you will not need that after you write for some days :) [13:46] ! [13:46] next [13:47] " HTML is a publishing format; Markdown is a writing format." please explain, kushal [13:47] Roll call:Shubham Sharma [13:47] priyankasaggu119, yup, good question. [13:48] priyankasaggu119, We write our text in markdown [13:48] say, *markdown* is a very nice for writing. [13:49] Here we are specifying that the word markdown is of importance, but not dealing with how it will look like in the web. [13:49] or in the final file which users will see. [13:49] HTML decides how the websites/pages will look like. [13:49] ! [13:49] That is the difference. [13:49] ok , got the point. Thankyou :) [13:49] Anyone else wants to answer priyankasaggu119 ? [13:50] HTML is for presentation on the web while markdown is for improve writting [13:50] isn't kushal? [13:51] here presentation == structure [13:51] sourabh_1031, not improve, but for writing without thinking about the final presentation look and feel. [13:52] But basically we can write in HTML also, so where comes the picture of Markdown in practical sense? I mean we can easily do all such things in HTML also. [13:52] priyankasaggu119, yes, but let us take an example. [13:52] priyankasaggu119, Markdown helps you write formatted documents very easily [13:53] If I ask you to type the line in HTML to create a link to https://example.com from the word Example, how will you do that? I will also type the same in markdown, let us see who can do it faster. [13:53] kushal sorry to interrupt but while writing markdown we think about the final format of writing [13:53] [Example](https://example.com) [13:53] done [13:53] I don't have worry about HTML syntax at all, we just write. [13:53] jasonbraganza, ^^ anything you want to add. [13:53] [13:53] no! [13:54] this was exactly what I wanted to say [13:54] ok ok [13:54] Markdown does not get in your way [13:54] sourabh_1031, were you telling kushal that? or asking him that? [13:55] jasonbraganza, i was asking [13:55] Ok, it's clear, i guess. Thanks alot kushal. [13:55] sorry to add ? [13:55] sourabh_1031, well try making a list in html [13:55] do you know how? [13:56] <__rex__> ! [13:56] yes using ul and ol tag [13:56] next [13:56] ! [13:56] kushal, Can we say that Markdown is for people who hate html syntax [13:56] sourabh_1031, that vs how do make a list in markdown? [13:56] * [13:57] rishibit, not hate, but for the people who wants to write [13:57] rishibit markdown is for people who want to write and not let syntax come in the way [13:57] why do I care about HTML, I just want to write. [13:57] sourabh_1031, so which is simpler? [13:57] ! [13:57] next [13:57] <__rex__> Is html an implementation of markup ? [13:57] sourabh_1031 lets say you have a 10 item l;st? [13:57] ul [13:58] okay markdown is used if we concern about writing? [13:58] kushal,That's it, no need to learn tedious HTML syntax [13:58] __rex__, No. [13:58] __rex__, It is an output format from markdown. [13:58] sourabh_1031 try writing a 100 word article in raw html vs markdown and then let me know :) [13:58] i think i got it thanks jasonbraganza [13:58] next [13:58] soory 1000 word :) [13:58] Is there any rpm package for markdown similar to docutils for rst ? [13:58] ananyo, did you try dnf install markdown ? [13:58] ! [13:59] kushal, No I didn't. Let me try [13:59] ananyo, rather dnf search markdown [13:59] kushal, ok [14:00] ! [14:00] next [14:00] pass, got my doubt cleared [14:00] next [14:00] can we use markdown inside vim? [14:01] prokbird, short answer yes [14:01] prokbird LONG ANSWER ANY TEXT EDITOR :) [14:01] sorry about the caps [14:01] next [14:01] i tried this sudo apt-get install markdown but nothing happened [14:01] jasonbraganza, thanks, np. [14:01] <__rex__> ! [14:02] sourabh_1031, do apt search markdown [14:02] I can see markdown/stable,stable 1.0.1-9 all [14:02] sourabh_1031, try searching . I have no good answer to that [14:02] kushal okay [14:02] jasonbraganza, np [14:03] sourabh_1031, i write in nano or vsc and convert using pandoc for eg. but there are a million markdown solutions [14:03] next [14:03] <__rex__> kushal, but abbreviation of html is " hyper text markup language " so I thought it was an implementation of markup, what am I misinterpreting from the abbreviation ? [14:04] ! [14:04] __rex__, what is the actual question? the abbreviation is correct [14:04] __rex__ oh markdown? [14:04] __rex__, markup is a generic word [14:04] __rex__, read the history of HTML from the wikipedia. [14:04] We [14:05] and then comeback and ask. [14:05] prabhu, ? [14:05] next [14:05] "By default, Markdown produces XHTML output for tags with empty elements". Please explain? [14:05] sd30
[14:05] <__rex__> jasonbraganza, how is html not a markup since the abbreviation makes it seem so ? [14:05] Sorry, [14:05] sd30, you can skip it for now if you do not know HTML etc. [14:05] kushal, okay [14:05] __rex__ it *is* markup [14:05] __rex__, markup != markdown [14:06] <__rex__> jasonbraganza, I'll read the wikipedia page [14:06] __rex__ yes [14:06] __rex__ or ask after class [14:06] <__rex__> kushal, I know that [14:06] ananyo, in Fedora 28, we also have discount-2.2.2-5.fc28.x86_64 [14:06] <__rex__> jasonbraganza, alright [14:06] sd30 element like those break tags are rendered according to the xhtml spec [14:07] sorry to interrupt anyone please share markdown link again [14:07] next [14:07] jasonbraganza, it's not very clear because I am not familiar with HTML but thank you :) [14:07] sourabh_1031, https://daringfireball.net/projects/markdown/ [14:07] avik thanks [14:07] kushal, Ok I will try that [14:08] sd30 which is why markdown is so handy. you don’t have to learn all the tags and specs just to write [14:08] kushal, I did a dnf search and got a lot of results [14:08] ananyo, Okay :) [14:09] jasonbraganza, understood [14:10] next [14:10] ananyo, i also in my ubuntu [14:10] ooh nice :) [14:10] i meant nobody had questions :) [14:10] sourabh_1031, Yeah let's see which works the best [14:10] jasonbraganza, I love Markdown. [14:11] so do I! [14:11] ananyo: sourabh_1031 pick one say “discount” and use it [14:11] every markdown implementation has some quirks but none we will run into for now [14:11] j605 okay [14:12] if you folks are using Visual Studio Code that has builtin markdown support if I’m not mistaken [14:13] I wanted to pass this URL for more reading (other topics) https://www.eff.org/john-perry-barlow [14:13] brb in 10 minutes [14:14] ! [14:14] ! [14:14] next [14:14] ! [14:15] after installing discount i typed markdown and it started [14:15] kushal: thanks for the links. Huge reading list :) [14:15] next [14:15] techno-utopianism ? [14:15] sourabh_1031 good :) [14:15] i mean to say do we need to type on terminal [14:15] ! [14:15] ? [14:15] j605, help sourabh_1031 ? [14:15] if you use discount that is? [14:15] next [14:16] ! [14:16] Is there builtin markdown support in atom as well? [14:16] sourabh_1031: use it as `markdown filename.md` [14:16] prokbird check. would surprise me if there wasn't [14:16] next [14:16] kushal, jasonbraganza Do Freedom of the Press Foundation & EFF have same goals? [14:16] j605 okay [14:16] rishibit nope [14:16] next [14:17] Markdown is easy then why people use HTML? [14:17] sourabh_1031: also, `man markdown` [14:17] poojaencoded, because HTML is ultimately the end product for the net [14:17] j605, did you mean vim markdown filename.md ? [14:18] poojaencoded, we use markdown as a convenience for us to *write* [14:18] poojaencoded, You can think of markdown as a higher level interface to HTML. [14:18] easier, but less powerful [14:18] poojaencoded, utltimately the markdown engine produces html so that everyone can *read* [14:19] prokbird: your question doesn't make sense. `vim markdown firename.md` will load vim with two files, “markdown” and “filename.md” [14:19] poojaencoded HTML is the standard. Markdown was made to make writing easier and more accessible. Is that clear enough? [14:19] next [14:19] prokbird to execute your file in terminal, use markdown filename.md [14:19] ok on a related note [14:19] how many of you write frequently now? [14:20] prokbird: in `markdown my_file.md` markdown is the binary that is executed and my_file.md is the argument, so the input that should be parsed to html [14:20] jasonbraganza:yes :) [14:20] me, I try to write once a week now [14:20] not frequently! :( [14:20] the silence is deeafening :) [14:20] me too (around once in a week) [14:21] jasonbraganza, i write on alternative days but at different platforms. [14:21] jasonbraganza, Not much. I need to make a habit of writing [14:21] ! [14:21] I try to [14:21] jasonbraganza, I write 2 blogs a week. [14:22] shiva, you write two posts. I write two blogs :P [14:22] jasonbraganza, Many a times, I write but not publish [14:22] philomath whatcha waiting for? Christmas? [14:22] jasonbraganza, I also try to write on every weekend. [14:22] jasonbraganza, yes 2 posts a week :) [14:22] jasonbraganza, Once a week [14:23] I also write once in a week. [14:23] how many would like to see me do a post breakdown? i don’t like mangling your posts but one of our heroes has volunteered [14:23] jasonbraganza, Just they are not yet complete (I feel). The documentation and details are not complete. And that ways, i have many drafts :( [14:23] philomath, just hit publis [14:23] publish [14:24] jasonbraganza, what is meant by post breakdown? [14:24] jasonbraganza, I will publish few articles this weekend then :) [14:24] means I review your post and tell you what could be better [14:24] j605, Sarques__ , schubisu : if i have to write in terminal let me know if this is correct or not ? vim filename.md and for execution we use markdown filename.md ? [14:24] jasonbraganza, surely :) [14:25] jasonbraganza: I don't mind criticism. I am thankful that you take the time to read and tell us what is wrong [14:25] jasonbraganza, That would be great :) [14:25] any body else interested? [14:25] jasonbraganza, me [14:25] jasonbraganza, me [14:25] prokbird: yes [14:25] me too [14:25] jasonbraganza, Great. me too [14:25] prokbird yes! for editing, use first, for execution use second :) [14:25] jasonbraganza sure :) [14:25] ok. [14:25] me [14:25] jasonbraganza, me! [14:25] jasonbraganza, i write but contribute to repos in form of technical documentation [14:26] yes, jasonbraganza. [14:26] prokbird: read the manual for more options as well [14:26] j605, Sarques__ schubisu thanks :) [14:26] sourabh_1031 it’s all writing :) [14:26] prokbird: correct, if you want to edit a file you use an editor (as vim). So in both cases you have an executable (vim, markdown) and pass an argument to it (filename.md) [14:26] jasonbraganza, sure that would be great! [14:26] so here’s the post https://farhaanbukhsh.wordpress.com/2016/10/20/pycon-india-2016/ [14:26] j605, you mean man page? [14:26] read it and be back in 2 mins [14:26] sourabh_1031: kushal helped with a wiki entry I wrote :) [14:27] prokbird: yes, man is manual [14:27] say done when you are [14:28] done? [14:29] j605 :) [14:29] we didn't have a session yesterday, right ? [14:29] slowpokes you are! [14:29] done? [14:30] done [14:30] nope [14:30] done [14:30] done [14:30] ! [14:30] next [14:30] who are BG and VanL? [14:30] done [14:30] done [14:30] next [14:30] ! [14:30] next [14:30] who are BG and VanL? [14:30] done [14:31] j605 you caUGHT ONE [14:31] NEXT [14:31] next [14:31] may i know what is going on ? I got disconnected and didn't have an entry in my calendar too [14:31] done [14:31] ok so what is good? and what do you think could be bettered? [14:31] quick now [14:31] Can anyone please confirm if they can see today's session in the calendar? [14:31] brute4s99: please don't butt in. wait and see what is going on [14:31] done [14:31] done [14:31] kushal i can [14:31] kushal: me too [14:31] done [14:32] me too [14:32] kushal me [14:32] kushal: i can [14:32] brute4s99, ^^ people can see the session, please check your settings. [14:32] kushal: okay let me see [14:32] kushal, i can [14:32] nobody has anything to say about the post? [14:32] I love the flow and how it is structured as Day1, Day2 [14:33] good! [14:33] what else? [14:33] jasonbraganza: there are things that only people who are in the group undertand about the post [14:33] *understand [14:33] j605, yea [14:33] anything else you folks have to say? [14:34] ok my turn [14:34] jasonbraganza: there can also be some introduction on what Pagure is or a link to it since fhackdroid gave a talk on pagure [14:34] There were few typos like a space before a comma. [14:34] jasonbraganza python logo was awesome :) [14:34] jasonbraganza, you want us to tell what stuff fascinates me? Like dgplug staircase meeting, coding for the love of coding even if it not gets merged et al. [14:34] nope :) [14:34] so fhackdroid got things mostly right [14:35] jasonbraganza, Post is nice but it seems that it has been written by keeping few people in mind. [14:35] it’s attractyve [14:35] it’s well structured [14:35] it’s a good length [14:35] ! [14:36] ! [14:36] and i picked this post because he probably was either in the training at the time or just fresh out of it [14:36] so basically where you folks are now [14:36] next [14:36] next [14:36] ! [14:36] can I atleast get a link of the webpage in reference here? please dm me someone. [14:36] jasonbraganza, what according to you is good length? How many words/lines [14:36] ? [14:37] Done [14:37] ash_mishra as loong as it needs be to describe what you’re writing about [14:37] fhackdroid wrote about 3 days in about 700 words [14:37] that’s nicely compressed. [14:37] brute4s99 https://farhaanbukhsh.wordpress.com/2016/10/20/pycon-india-2016/ [14:37] next [14:37] jasonbraganza, ok [14:38] jasonbraganza, I found 2 typos in your post. [14:38] jasonbraganza: thank you [14:38] jasonbraganza, keeping paragraph short ,nicely structured. [14:38] prabhu, the one I wote? or fhackdroid original? [14:38] T his (spacing) [14:38] so here are the things to worry about [14:39] 1. who you are wrting for. are you clear about that? [14:39] 2. are you telling a good story [14:39] typos and spacing meh! people will point that out to you as soon as you hit publish [14:40] so where were we? [14:40] yes he has good structure and wrote really well [14:41] j605 pointed out one crucial thing. that’s because he innately felt it [14:41] fhackdroid drops names [14:41] but does not link to them or describe them [14:41] if you do that, the reader feels left out [14:42] who’s bg? who’s vanl? why do I care? [14:42] so involve the reader. even if it only is future you [14:42] i write for me [14:42] or my friends [14:42] that is my audience [14:43] and even I sometimes go back to an old post and go huh? [14:43] so that is one thing I would fix [14:44] then I’d fix the rhythm [14:44] it is day 1 /2/3 but i should not have to feel the days. I should be tken from one little event to another. I’d try and do that [14:45] the sentences are slightly run on. I’d make them short punchy paras [14:45] so I did all that [14:46] other than fixing up the links to folks, because I was too tired today [14:46] so read this, https://janusworx.com/pycon-india-2016-farhaan-bukhsh.html [14:46] and tell me if it’s better than the original [14:47] two mins [14:47] go [14:48] Is session going on here? I'm from Australia [14:48] It is better. It looks more structured and neat [14:48] jasonbraganza, I believe fhackdroid used VanL and BG as they would be their IRC nicks in the channel. [14:49] You changed their nicks to their name that makes it better for the reader [14:49] philomath, see you had to explain that to me. a post should be self explanaatory [14:49] philomath, i changed their names and I should have linked to their work [14:49] that would have been the final fix [14:50] also Pagure. it’s obscure enough that it needs a link so that I know what irt is I want to know [14:50] the point is not to leave the reader out [14:51] I believe there can be more detail on what weechat is [14:51] philomath now yousee :) [14:52] but it’s up to the author. everything cannot be linked out to! :) [14:52] the one thing I haven’t done is change his voice [14:52] PR is pretty vague over here. [14:52] philomath enough now :) [14:52] Its a lot improved [14:52] jasonbraganza: can a simple wikipedia hyperlink to such things be enough ? [14:52] brute4s99 yes [14:53] jasonbraganza: “Baishampayan” love the name :D also you used ellipsis :) I need to write more to find proper uses for it [14:53] jasonbraganza, So, here's my take, write however you like at first and get everything you can written down but should filter the typos, link people later. [14:54] here’s what i do [14:54] get tthe ideas down on paper [14:54] in whatever order [14:55] quote i know i want to include. phrases i need [14:55] pics and links i want [14:55] all in [14:55] the I think of a story. [14:55] what do I want to say? [14:56] then I weave the facts I have into the story I want to tell [14:56] good example of that woule be my intention post [14:56] https://janusworx.com/on-intention.html [14:56] i wanted to talk about mindfulness and meditation [14:57] but i know the moment I said something like that all you young folk would intsantly turn off [14:57] sorry wrong link [14:57] I meant focus - https://janusworx.com/want-to-focus.html [14:58] jasonbraganza, Wow, thanks for the sharing your blogging "secrets" with us :) [14:58] once the story is done. the I give folks the means to go out and expand on the story [14:58] that’s where the inclusivity and the links and the references come in [14:59] then i see whether I can shorten it [14:59] as it is when you tell the story 9/10ths of your research falls on the floor [14:59] can you make it shorter? tighter? give it a rhythm? [15:00] and then you can do the typos :) [15:00] i have no shame btw [15:00] i post after the story is done [15:00] i pay no heed to typos or length [15:01] because I keep working on the post :) [15:01] so if it’s on your own blog, give your self free rein [15:01] because no one else is going to [15:01] and that’s the power of these machines called blogs [15:02] if i had to write for someone, I have to hit a deadline, i cannot use my voice (which is only fair) and i have to work to their specs [15:02] so folowing my own rules and summarising [15:03] 1. Know who you are writimng for [15:03] 2. Write [15:03] 3. Write some more :) [15:03] I will pick up my python reins next week [15:04] and there the audience is me [15:04] i want two things [15:04] 1. a measure of daily progress, which is what the short daily progress notes are about [15:05] 2. a way to express what I’ve learnt in my own words which will be longer posts (like my book notes) [15:06] and a bit of humour because I’m always frustrated when I’m looking things up. Past me always cheers up present me :) [15:06] i think we’ll call it a night :) [15:06] questions anyone? [15:07] ! [15:07] ! [15:07] also please read the blogging secrtion in the summer training guide. that explains why to write :) [15:07] next [15:07] Is writing twice a week enough? [15:08] ! [15:08] kps depends on what you want out of writing in the ling term [15:08] kps if you’re just documenting for your self, yes [15:08] Ok jasonbraganza [15:08] ! [15:09] kps if you’re building a portfolio and body of work to gain an audience or for future prospects, you need to write more [15:09] next [15:09] jasonbraganza: As you picked Mamata Venkat as your example for the post, how are we supposed to pick our examples for the blog post ? Can you please guide us on that? [15:09] Ok [15:09] brute4s99, research :) and reading,. I read a lot, so I know where I read something or saw something [15:10] brute4s99, if you don’t you just have to work harder and do more research. like I said, you research 10 things and end up using 1 [15:10] next [15:10] got it, jasonbraganza . Thank you! [15:10] jasonbraganza: Should we have to build up our reading skills also ? [15:11] spythrone ths shows you havent read the blogging chapter :P [15:11] ! [15:11] anyone knows what I ensded with? [15:11] Read more than you write, live more than you read. [15:11] next [15:11] jasonbraganza, How to know that where to add links? [15:11] jasonbraganza: Thanks [15:12] prabhu if you cabn’t make out ask someone else to read it. link out to whatever they go huh at [15:12] next [15:12] jasonbraganza, You use paper to write down ideas for every posts? [15:12] [15:13] Thanks kushal, jasonbraganza for today's session. Logging off now [15:13] jasonbraganza, thanks! [15:13] [15:13] no no. i mean i do. you don’t have to. just write it all down some place. pad computer phone, no matter [15:13] next [15:13] aright then :) [15:14] Roll Call [15:14] Jason Braganza [15:14] Gajendra Saraswat [15:14] tabrez khan [15:14] Mohit Bansal [15:14] Shruti Dash [15:14] Priyanka Saggu [15:14] Prashant Sharma [15:14] Prabhu Sharan Singh [15:14] Shiva Saxena [15:14] Bhavin Gandhi [15:14] Jagannathan Tiruvallur Eachambadi [15:14] Aditya Patil [15:14] Shital Mule [15:14] Pragyat Singh Rana [15:14] Ola Ajayi [15:14] Anu Kumari Gupta [15:14] Shamik Nandi [15:14] Sehenaz Parvin [15:14] Piyush Aggarwal [15:15] Ashish Kumar Mishra [15:15] Bhavesh Gupta [15:15] alright and if you want to know what chanhed between the two posts, you can see the whole process here - https://github.com/jasonbraganza/words/commits/master ----END CLASS----