Radar de noticias de Artes Multimediales


Los artículos a continuación fueron publicados en sus respectivos canales, el contenido y las opiniones expresadas son de exclusiva responsabilidad de los autores; su recopilación en esta página es sin fines de lucro y no tiene otro motivo que la divulgación de temas relacionados a la carrera.

Estamos mejorando la lista de canales, por favor, si seguís algun blog interesante no dejes de sugerirlo.

Neural Articles and Issues

http://www.neural.it [actualidad]

Opensource.com

https://opensource.com/ [código-abierto]

Writing project documentation in HTML #

Writing project documentation in HTML Jim Hall Fri, 08/12/2022 - 03:00
2 readers like this
2 readers like this

Documentation is an important part of any technical project. Good documentation tells the end user how to run the program, how to use it, or how to compile it. For many projects, plain text documentation is the standard. After all, every system can display plain text files.

However, plain text is limiting. Plain text files lack formatting elements like italics text, bold text, and titles. To add these elements, we can leverage HTML. HyperText Markup Language (HTML) is the markup language used in all web browsers. And with a little extra effort, you can use HTML to write project documentation that can be read by everyone.

HTML uses a series of tags enclosed in angle brackets to control how different parts of a document should be displayed. These tags define elements in an HTML document, such as document headings, paragraphs, italics text, bold text, and other kinds of text. Almost every tag comes in a pair: an opening tag, like

to start a paragraph, and a closing tag to end the element, such as

to end a paragraph. When using these tags, remember this rule: if you open a tag, you need to close it. Not closing a tag properly can result in the web browser incorrectly.

Some tags define a block within the HTML document, while others are inline. For more information about block and inline elements, read my other article about a gentle introduction to HTML.

Start an empty document

Begin by creating a boilerplate empty HTML document. Every HTML document should provide a document type declaration. Use the single tag on the first line of the HTML file to define an HTML document. The HTML standard also requires that pages wrap the document text in two block elements: to define the HTML document, and to define the body text. While HTML doesn't require indenting each new code block, but I add it anyway so you can see that is actually "inside" the block:


<html>
  <body>
 
  </body>
</html>

HTML documents also need a block before the that provides extra information called metadata about the page. The only required metadata is the title of the document, defined by the element. An empty document might look like this:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5"><span class="sc0"><!DOCTYPE html></span><br /> <span class="sc2"><<a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span>Title of the document<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br />   <br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br /> <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span></div></div></pre><h2>Add the text</h2> <p>Let's exercise some HTML knowledge by adapting an existing plain text "Readme" file to HTML. For this example, I'm using part of the documentation about how to play an open source board game, called Simple Senet:</p> <pre> <div class="geshifilter"><div class="text geshifilter-text">HOW TO PLAY SIMPLE SENET<br /> <br /> The game will automatically "throw" the throwing sticks for you, and<br /> display the results in the lower-right corner of the screen.<br /> <br /> If the "throw" is zero, then you lose your turn.<br /> <br /> When it's your turn, the game will automatically select your first<br /> piece on the board. You may or may not be able to make a move with<br /> this piece, so select your piece to move, and hit Space (or Enter) to<br /> move it. You can select using several different methods:<br /> <br /> -  Up/down/left/right to navigate to a specific square.<br /> <br /> -  Plus (+) or minus (-) to navigate "left" and "right" on the<br />    board. Note that this will automatically follow the "backwards S"<br />    shape of the board.<br /> <br /> -  Tab to select your next piece on the board.<br /> <br /> To quit the game at any time, press Q (uppercase Q) or hit Esc, and<br /> the game will prompt if you want to forfeit the game.<br /> <br /> You win if you move all of your pieces off the board before your<br /> opponent. It takes a combination of luck and strategy!</div></div></pre><p>Start by adding this Readme text into your empty HTML file. The main content of an HTML page is the <body>, so that's where you put the text:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5"><span class="sc0"><!DOCTYPE html></span><br /> <span class="sc2"><<a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span>Title of the document<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br />     HOW TO PLAY SIMPLE SENET<br />     <br />     The game will automatically "throw" the throwing sticks for you, and<br />     display the results in the lower-right corner of the screen.<br />     <br />     If the "throw" is zero, then you lose your turn.<br />     <br />     When it's your turn, the game will automatically select your first<br />     piece on the board. You may or may not be able to make a move with<br />     this piece, so select your piece to move, and hit Space (or Enter) to<br />     move it. You can select using several different methods:<br />     <br />     - Up/down/left/right to navigate to a specific square.<br />     <br />     - Plus (+) or minus (-) to navigate "left" and "right" on the<br />       board. Note that this will automatically follow the "backwards S"<br />       shape of the board.<br />     <br />     - Tab to select your next piece on the board.<br />     <br />     To quit the game at any time, press Q (uppercase Q) or hit Esc, and<br />     the game will prompt if you want to forfeit the game.<br />     <br />     You win if you move all of your pieces off the board before your<br />     opponent. It takes a combination of luck and strategy!<br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br /> <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span></div></div></pre><p>Without further changes, this HTML document looks completely wrong when you view it in a web browser. That's because HTML, like most markup systems, collects <em>words</em> from the input file and fills <em>paragraphs</em> in the output. Because you have not yet added other markup, a web browser displays the text in a single paragraph:</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-1.webp" width="940" height="270" alt="This is how a web browser displays our bare HTML file." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <h2>Body paragraphs</h2> <p>Your first step in updating this Readme file to HTML is to mark every paragraph so the web browser can display it properly. The tag to define a paragraph is <p>. While not everything in this file is actually a paragraph, start by wrapping everything in <p> and </p> tags:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5"><span class="sc0"><!DOCTYPE html></span><br /> <span class="sc2"><<a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span>Title of the document<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>HOW TO PLAY SIMPLE SENET<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>The game will automatically "throw" the throwing sticks for you, and<br />     display the results in the lower-right corner of the screen.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>If the "throw" is zero, then you lose your turn.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>When it's your turn, the game will automatically select your first<br />     piece on the board. You may or may not be able to make a move with<br />     this piece, so select your piece to move, and hit Space (or Enter) to<br />     move it. You can select using several different methods:<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>- Up/down/left/right to navigate to a specific square.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>- Plus (+) or minus (-) to navigate "left" and "right" on the<br />          board. Note that this will automatically follow the "backwards S"<br />          shape of the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>- Tab to select your next piece on the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>To quit the game at any time, press Q (uppercase Q) or hit Esc, and<br />     the game will prompt if you want to forfeit the game.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>You win if you move all of your pieces off the board before your<br />     opponent. It takes a combination of luck and strategy!<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br /> <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span></div></div></pre><p>This makes the Readme look more like a document you want to read. When you view the new document in a web browser, every paragraph starts on a new line, with some extra space above and below. The paragraph is the most common example of a block element.</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-2.webp" width="960" height="597" alt="Our first step is to define everything as paragraphs." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <p></p><div class="embedded-resource-list callout-float-right"> <div class="field field--name-title field--type-string field--label-hidden field__item">More great content</div> <div class="field field--name-links field--type-link field--label-hidden field__items"> <div class="field__item"><a href="https://www.redhat.com/en/services/training/rh024-red-hat-linux-technical-overview?intcmp=7016000000127cYAAQ">Free online course: RHEL technical overview</a></div> <div class="field__item"><a href="https://developers.redhat.com/cheat-sheets/advanced-linux-commands/?intcmp=7016000000127cYAAQ">Learn advanced Linux commands</a></div> <div class="field__item"><a href="https://opensource.com/downloads/cheat-sheets?intcmp=7016000000127cYAAQ">Download cheat sheets</a></div> <div class="field__item"><a href="https://opensource.com/tags/linux?intcmp=7016000000127cYAAQ">Find an open source alternative</a></div> <div class="field__item"><a href="https://opensource.com/resources?intcmp=7016000000127cYAAQ">Explore open source resources</a></div> </div> </div> <h2>Headings and subheadings</h2> <p>The first line in your content is your document's title, so you should make this into a heading. HTML provides six levels of headings, from <h1> to <h6>. In most documents, you might use <h1> to define the title of the document, and <h2> for major subsections. Make this change in your sample Readme document. Use the name of the program ("Simple Senet") as the main section title, and "How to Play" as a subsection in the document.</p> <p>Note that in this example, I've also updated the <title> in the document metadata to use the same title as the <h1> heading. This doesn't actually change how browsers display the document, but it is a good practice to use:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5"><span class="sc0"><!DOCTYPE html></span><br /> <span class="sc2"><<a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span>Simple Senet<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/h1.html"><span class="kw2">h1</span></a>></span>Simple Senet<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/h1.html"><span class="kw2">h1</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/h2.html"><span class="kw2">h2</span></a>></span>How to Play<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/h2.html"><span class="kw2">h2</span></a>></span><br />     ...<br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br /> <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span></div></div></pre><p>By adding these section headings, you've made the document easier to read:</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-3.webp" width="940" height="197" alt="By itself, HTML will display headings and subheadings in a different style than the paragraphs." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <h2>Ordered and unordered lists</h2> <p>Your document includes a list of different ways to navigate the board game. Because this document started out as a plain text file, each item in the list starts with a hyphen. But you can use HTML to define these three paragraphs as list items.</p> <p>HTML supports two kinds of lists: <em>ordered</em> and <em>unordered</em> lists. An ordered list <ol> is a numbered series, which you might use to define a sequence of steps. An unordered list <ul> defines a list of items that may or may not be related, but are generally not done in order. Both lists use list items <li> for entries within the list.</p> <p>Update the Readme document to use an ordered list instead of paragraphs. This presents the three navigation options in a numbered list:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5">   <span class="sc2"><<a href="http://december.com/html/4/element/ol.html"><span class="kw2">ol</span></a>></span><br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Up/down/left/right to navigate to a specific square.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br /> <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Plus (+) or minus (-) to navigate "left" and "right" on the<br />           board. Note that this will automatically follow the "backwards S"<br />           shape of the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Tab to select your next piece on the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/ol.html"><span class="kw2">ol</span></a>></span></div></div></pre><p>This presents the three options in a numbered list:</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-4.webp" width="940" height="108" alt="The three options are in an ordered list, numbered 1, 2, and 3." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <p>However, these three items aren't really a sequence of steps, but different options to move the selection in the Simple Senet game. So instead of an ordered list, we want to use an unordered list. This requires updating the <ol> to <ul> in the document:</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5">   <span class="sc2"><<a href="http://december.com/html/4/element/ul.html"><span class="kw2">ul</span></a>></span><br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Up/down/left/right to navigate to a specific square.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br /> <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Plus (+) or minus (-) to navigate "left" and "right" on the<br />           board. Note that this will automatically follow the "backwards S"<br />           shape of the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Tab to select your next piece on the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/ul.html"><span class="kw2">ul</span></a>></span></div></div></pre><p>The unordered list uses bullets for each list item, because the entries are not part of a sequence:</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-5.webp" width="940" height="108" alt="The three options are in an unordered or bulleted list." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <h2>Bold and italics</h2> <p>You can highlight certain information in the document by applying <strong>bold</strong> and <em>italics</em> styles. These are very common text styles in technical writing. You might use bold to highlight important information, or italics to emphasize key phrases and new terms.</p> <p>The bold tag was originally defined as <b>, but newer versions of the HTML standard prefer the <strong> tag to indicate strong importance, such as key steps in a set of instructions. Both tags are valid, but are semantically slightly different. <b> now means "bring attention to."</p> <p>Similarly, the original HTML standard used <i> for italics text. Later versions of HTML instead prefer <em> to bring emphasis to parts of the text. Instead, <i> now identifies idiomatic text or technical terms.</p> <p>For this example, use bold to identify the single-letter keypresses, and italics to indicate special keys on a keyboard like <em>Enter</em> and <em>Space</em>. For simplicity, use <b> and <i> tags here (but you could use <strong> and <em> tags instead to get the same effect:)</p> <pre> <div class="geshifilter"><div class="html5 geshifilter-html5"><span class="sc0"><!DOCTYPE html></span><br /> <span class="sc2"><<a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span>Simple Senet<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/title.html"><span class="kw2">title</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/head.html"><span class="kw2">head</span></a>></span><br />   <span class="sc2"><<a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/h1.html"><span class="kw2">h1</span></a>></span>Simple Senet<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/h1.html"><span class="kw2">h1</span></a>></span><br />     <span class="sc2"><<a href="http://december.com/html/4/element/h2.html"><span class="kw2">h2</span></a>></span>How to Play<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/h2.html"><span class="kw2">h2</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>The game will automatically "throw" the throwing sticks for you, and<br />     display the results in the lower-right corner of the screen.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>If the "throw" is zero, then you lose your turn.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>When it's your turn, the game will automatically select your first<br />     piece on the board. You may or may not be able to make a move with<br />     this piece, so select your piece to move, and hit <span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>Space<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span> (or <span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>Enter<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>) to<br />     move it. You can select using several different methods:<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br /> <br />     <span class="sc2"><<a href="http://december.com/html/4/element/ul.html"><span class="kw2">ul</span></a>></span><br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>Up<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>/<span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>down<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>/<span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>left<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>/<span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>right<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span> to navigate to a specific square.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br /> <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span>Plus (<span class="sc2"><<a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span>+<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span>) or minus (<span class="sc2"><<a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span>-<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span>) to navigate "left" and "right" on the<br />           board. Note that this will automatically follow the "backwards S"<br />           shape of the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <br />       <span class="sc2"><<a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>><<a href="http://december.com/html/4/element/em.html"><span class="kw2">em</span></a>></span>Tab<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/em.html"><span class="kw2">em</span></a>></span> to select your next piece on the board.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/li.html"><span class="kw2">li</span></a>></span><br />     <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/ul.html"><span class="kw2">ul</span></a>></span><br /> <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>To quit the game at any time, press <span class="sc2"><<a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span>Q<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/b.html"><span class="kw2">b</span></a>></span> (uppercase Q) or hit <span class="sc2"><<a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>Esc<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/i.html"><span class="kw2">i</span></a>></span>, and<br />     the game will prompt if you want to forfeit the game.<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />     <br />     <span class="sc2"><<a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span>You win if you move all of your pieces off the board before your<br />     opponent. It takes a combination of luck and strategy!<span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/p.html"><span class="kw2">p</span></a>></span><br />   <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/body.html"><span class="kw2">body</span></a>></span><br /> <span class="sc2"><<span class="sy0">/</span><a href="http://december.com/html/4/element/html.html"><span class="kw2">html</span></a>></span></div></div></pre><p>These extra styles help special items to stand out in the text:</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/html-senet-6.webp" width="960" height="662" alt="The extra formatting makes these gameplay instructions easier to read." /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Jim Hall, CC BY-SA 4.0)</p> </div> </article> <p>The point of writing documentation is for users to understand how to use the software, so every open source project should make the effort to write documentation in a way that is easy to read. With a few basic HTML tags, you can write documentation that presents the information more clearly to your users.</p> <p>For more information on using HTML to write documentation, check out the complete <a href="https://developer.mozilla.org/en-US/docs/Web/HTML" target="_blank">HyperText Markup Language reference</a> at MDN, the Mozilla Developer Network, hosted by the Mozilla web project.</p> </div> <div class="clearfix text-formatted field field--name-field-article-subhead field--type-text-long field--label-hidden field__item"><p>HyperText has more features than plain text to level up your documentation.</p> </div> <div class="field field--name-field-lead-image field--type-entity-reference field--label-hidden field__item"><article class="media media--type-image media--view-mode-caption"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/lead-images/documentation-type-keys-yearbook.png" width="520" height="292" alt="5 trends in open source documentation" title="5 trends in open source documentation" /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>Internet Archive Book Images. Modified by Opensource.com. CC BY-SA 4.0</p> </div> </article> </div> <div class="field field--name-field-tags field--type-entity-reference field--label-hidden field__items"> <div class="field__item"><a href="https://opensource.com/tags/programming" hreflang="en">Programming</a></div> <div class="field__item"><a href="https://opensource.com/tags/linux" hreflang="en">Linux</a></div> <div class="field__item"><a href="https://opensource.com/tags/documentation" hreflang="en">Documentation</a></div> </div> <div class="hidden field field--name-field-listicle-title field--type-string field--label-hidden field__item">What to read next</div> <div class="field field--name-field-listicles field--type-entity-reference field--label-hidden field__items"> <div class="field__item"><a href="https://opensource.com/article/22/7/fmt-trivial-text-formatter" hreflang="en">How I use the Linux fmt command to format text</a></div> <div class="field__item"><a href="https://opensource.com/article/22/8/automate-file-edits-sed-linux" hreflang="en">How I use the Linux sed command to automate file edits</a></div> <div class="field__item"><a href="https://opensource.com/article/22/8/old-school-technical-writing-groff" hreflang="en">Old-school technical writing with groff</a></div> <div class="field__item"><a href="https://opensource.com/article/22/8/pdf-latex" hreflang="en">Create beautiful PDFs in LaTeX</a></div> <div class="field__item"><a href="https://opensource.com/article/22/8/gentle-introduction-html" hreflang="en">A gentle introduction to HTML</a></div> </div> <div class="field field--name-field-default-license field--type-list-string field--label-hidden field__item"><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/"> <img alt="Creative Commons License" src="https://opensource.com/themes/osdc/assets/img/cc-by-sa-4.png" title="This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License." /></a>This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.</div> <section id="comments" class="field field--name-field-comments field--type-comment field--label-hidden comment-wrapper"> <div class="comments__count"> <h2>3 Comments</h2> <div class="login"><a href="https://opensource.com/user/register?absolute=1">Register</a> or <a href="https://opensource.com/user/login?current=/rss.xml&absolute=1">Login</a> to post a comment.</div> </div> <article data-comment-user-id="30666" id="comment-219748" class="comment js-comment"> <mark class="hidden" data-comment-timestamp="1660309319"></mark> <footer class="comment__meta"> <article class="media media--type-image media--view-mode-byline"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/styles/medium/public/20150529_gregp.jpg?itok=pjjrMm9R" width="189" height="220" class="image-style-medium" /> </div> </article> <div> <div class="comment__submitted"> <a href="https://opensource.com/users/greg-p">Greg Pittman</a> | August 12, 2022 </div> <div class="content"> <div class="clearfix text-formatted field field--name-comment-body field--type-text-long field--label-hidden field__item"><p>A useful command that doesn't come in a pair is the break command, .<br /> What it does is add a line break, but unlike </p><p>, it doesn't add an empty line in between.</p> </div> <drupal-render-placeholder callback="flag.link_builder:build" arguments="0=comment&1=219748&2=report_as_spam" token="PhdG61Y3T5hW4PuM6BfCyhvHOmoQ7cf67C4QDfshKPc"></drupal-render-placeholder><drupal-render-placeholder callback="comment.lazy_builders:renderLinks" arguments="0=219748&1=full&2=en&3=" token="w2lO3Acgcj2ymjDW2IoOMGvF3hNR0W11trjtcm97zZw"></drupal-render-placeholder> </div> </div> </footer> </article> <div class="indented"> <article data-comment-user-id="30666" id="comment-219749" class="comment js-comment"> <mark class="hidden" data-comment-timestamp="1660309476"></mark> <footer class="comment__meta"> <article class="media media--type-image media--view-mode-byline"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/styles/medium/public/20150529_gregp.jpg?itok=pjjrMm9R" width="189" height="220" class="image-style-medium" /> </div> </article> <div> <div class="comment__submitted"> <a href="https://opensource.com/users/greg-p">Greg Pittman</a> | August 12, 2022 </div> <div class="content"> <div class="clearfix text-formatted field field--name-comment-body field--type-text-long field--label-hidden field__item"><p>Trying to fix this:<br /> A useful command that doesn't come in a pair is the break command, \.<br /> What it does is add a line break, but unlike \<br /> </p><p> </p><p>, it doesn't add an empty line in between.</p> </div> <drupal-render-placeholder callback="flag.link_builder:build" arguments="0=comment&1=219749&2=report_as_spam" token="Z13iB7T8iAHo1kOaS2UkjOyJ995MkL_2ItzF_t-Tb38"></drupal-render-placeholder><drupal-render-placeholder callback="comment.lazy_builders:renderLinks" arguments="0=219749&1=full&2=en&3=" token="agCFLQGHBTr3AxZLM1P9_sYMCBBOgQt3ZU1pweCb3j0"></drupal-render-placeholder> </div> </div> <p class="parent visually-hidden">In reply to <a href="https://opensource.com/comment/219748#comment-219748" class="permalink" rel="bookmark" hreflang="en">A useful command that doesn…</a> by <a title="View user profile." href="https://opensource.com/users/greg-p" class="username">Greg Pittman</a></p> </footer> </article> </div> <article data-comment-user-id="30666" id="comment-219750" class="comment js-comment"> <mark class="hidden" data-comment-timestamp="1660309649"></mark> <footer class="comment__meta"> <article class="media media--type-image media--view-mode-byline"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/styles/medium/public/20150529_gregp.jpg?itok=pjjrMm9R" width="189" height="220" class="image-style-medium" /> </div> </article> <div> <div class="comment__submitted"> <a href="https://opensource.com/users/greg-p">Greg Pittman</a> | August 12, 2022 </div> <div class="content"> <div class="clearfix text-formatted field field--name-comment-body field--type-text-long field--label-hidden field__item"><p>Trying again:<br /> break tag = </br><br /> paragraph = <p></p> </div> <drupal-render-placeholder callback="flag.link_builder:build" arguments="0=comment&1=219750&2=report_as_spam" token="SAxuHlKsLNhIcyiGjOlnxSJh9Wd5BWmmLoE6z4jnxa8"></drupal-render-placeholder><drupal-render-placeholder callback="comment.lazy_builders:renderLinks" arguments="0=219750&1=full&2=en&3=" token="ygVpDfTLxiHr11jCu2YQ0foj6y1rXsxA1VyH4OZT6bg"></drupal-render-placeholder> </div> </div> </footer> </article> </section> </div> <footer> <span class="fecha">en <a target="_blank" href="https://opensource.com/"> Opensource.com </a> 12/08/22 04:00 </span> </footer> </article> <article id="how-i-get-students-excited-about-math-with-python-and-raspberry-pi"> <header> <h4> <a target="_BLANK" href="https://opensource.com/article/22/8/math-python-raspberry-pi">How I get students excited about math with Python and Raspberry Pi</a> <span class="anchor"> <a id="id-1_1" href="#how-i-get-students-excited-about-math-with-python-and-raspberry-pi">#</a> </span> </h4> </header> <div class="content"> <span class="field field--name-title field--type-string field--label-hidden">How I get students excited about math with Python and Raspberry Pi</span> <span class="field field--name-uid field--type-entity-reference field--label-hidden"><a title="View user profile." href="https://opensource.com/users/don-watkins" class="username">Don Watkins</a></span> <span class="field field--name-created field--type-created field--label-hidden">Fri, 08/12/2022 - 03:00</span> <div data-drupal-selector="rate-node-70140" class="rate-widget-thumbs-up" title="Register or Login to like."> <div class="rate-thumbs-up-btn-up vote-pending">3 readers like this</div> <div class="rate-score">3 readers like this</div> </div> <div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item"><p>I am teaching Python using <a href="https://opensource.com/article/21/6/teach-python-raspberry-pi" target="_blank">Raspberry Pi 400</a> computers in a local library for the second year in a row. A couple of this year's students have not experienced success with mathematics in their school. One asked me if she needed algebra to attend our class. I told her I had failed algebra, geometry, and trigonometry in school. She was relieved. Another student rushed in the door a bit late because she was taking geometry in summer school after failing to pass the course during the school year. I shared my own story of learned helplessness and my distress at the thought of math tests. My own bad experiences impacted my high school and early college years.</p> <p>I like Python, and in particular, the <code>turtle</code> module, because of an experience in graduate school in the early 1990s. The exercise used Apple's logo to teach students geometry, leading to an epiphany that completely changed my attitude toward mathematics. This week's class has four eighth-grade students. Two have math backgrounds, and two have math phobias. On the first day of class in the Olean Public Library, we started with a brief explanation of the RaspberryPi 400 and how to connect each of those computers to old VGA monitors that came from storage. I gave the students a brief overview and tour of the ports, peripheral mouse, and microHDMI cable we would use. We proceeded, step by step, to assemble the parts of the Raspberry Pi 400 units and connect them to the monitors. We powered up the units, and I assisted the students as they properly configured their computers for the United States and the Eastern Time Zone. We connected to the library's wireless network and were ready to begin.</p> <p></p><div class="embedded-resource-list callout-float-right"> <div class="field field--name-title field--type-string field--label-hidden field__item">More on Raspberry Pi</div> <div class="field field--name-links field--type-link field--label-hidden field__items"> <div class="field__item"><a href="https://opensource.com/resources/what-raspberry-pi?intcmp=7016000000127cYAAQ">What is Raspberry Pi?</a></div> <div class="field__item"><a href="https://opensource.com/downloads/raspberry-pi-guide?intcmp=7016000000127cYAAQ">eBook: Guide to Raspberry Pi</a></div> <div class="field__item"><a href="https://opensource.com/downloads/getting-started-raspberry-pi-cheat-sheet?intcmp=7016000000127cYAAQ">Getting started with Raspberry Pi cheat sheet</a></div> <div class="field__item"><a href="https://opensource.com/downloads/kubernetes-raspberry-pi?intcmp=7016000000127cYAAQ">eBook: Running Kubernetes on your Raspberry Pi</a></div> <div class="field__item"><a href="https://www.redhat.com/en/resources/data-intensive-applications-hybrid-cloud-blueprint-detail?intcmp=7016000000127cYAAQ">Whitepaper: Data-intensive intelligent applications in a hybrid cloud blueprint</a></div> <div class="field__item"><a href="https://www.redhat.com/en/topics/edge-computing?intcmp=7016000000127cYAAQ">Understanding edge computing</a></div> <div class="field__item"><a href="https://opensource.com/tags/raspberry-pi?intcmp=7016000000127cYAAQ">Our latest on Raspberry Pi</a></div> </div> </div> <p>I gave the students a brief overview of all the software on their computers. Then I introduced them to the <a href="https://opensource.com/article/20/9/teach-python-mu" target="_blank">Mu-Editor</a> that comes pre-installed on their computers. We reviewed the <a href="https://learn.adafruit.com/welcome-to-circuitpython/the-repl" target="_blank">Read-Evaluate-Print-Loop</a> (REPL). I explained that while we could execute code in the REPL, they would find it easier to write the code in the Mu-Editor and then save their code with a <code>.py</code> extension to ensure that the system could execute it properly. I explained how our code needed comments and how to add and save them properly.</p> <pre> <code># first program print("Hello World")</code></pre><p>Then I introduced them to the <code>turtle</code> module. We talked about the elements of a square; that squares are made up of four equal sides and contain 90-degree angles. We wrote the following code together, saved our work, and executed it.</p> <pre> <code># First Turtle Square import turtle turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90)</code></pre><p>I explained how to change the code and add features like a different pen color and a different color background.</p> <pre> <code># First Turtle Square import turtle turtle.pencolor("blue") turtle.bgcolor("yellow") turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90) turtle.forward(200) turtle.right(90)</code></pre><p>I introduced them to the <code>turtle.shape</code> to change from the default to look more like a turtle. I encouraged them to save each time and to iterate. They had fun sharing their results.</p> <p>In our second session, I demonstrated how to use a <em>for</em> loop to draw a square and how to clean up the code by assigning the "turtle" to a specific letter. Then I ran the code.</p> <pre> <code>#For Loop import turtle as t for x in range(4): t.forward(200) t.right(91)</code></pre><p>One of the students who had experienced mathematics problems in the past said, "That square looks crooked."</p> <p>I said, "You're right. What's wrong with it?"</p> <p>She let me know that my <code>t.right</code> should be <code>90</code> and not <code>91</code>. I corrected the error and reran the code. It looked perfect, and she was proud to have experienced some success with mathematics.</p> <p>We changed our code, and I introduced them to new possibilities within the turtle module, including speed, pen color, and background color. They enjoyed it when I demonstrated how we could easily create a square spiral using the following code:</p> <pre> <code># square spiral import turtle as t t.speed(0) t.bgcolor("blue") t.pencolor("yellow") for x in range(200): t.forward(x) t.right(91)</code></pre><p>We changed our code again to make circle spirals. The students were leaning into the learning, and our ninety-minute class came to an end. One of the students is in summer school re-taking geometry which she failed during the school year, and each day she runs a block and a half to make it to our class, where she excels at constructing geometric shapes. She has a great eye for detail and regularly helps the other students identify errors in their code. Her watchful eye inspired me to discuss the value of open source software and the power of many eyes on the code with the group.</p> <article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/yellow.jpg" width="610" height="814" alt="circle spirals rendered by python code" /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Don Watkins, CC BY-SA 4.0)</p> </div> </article> <pre> <code># circle spiral import turtle as t t.speed(0) t.bgcolor("blue") t.pencolor("yellow") for x in range(100): t.circle(x*2) t.right(91) t.setpos(60,75) for x in range(100): t.circle(x) t.right(91)</code></pre><article class="align-center media media--type-image media--view-mode-default"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/2022-08/blue.jpg" width="664" height="884" alt="blue spiral of squares rendered from Python code" /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>(Don Watkins, CC BY-SA 4.0)</p> </div> </article> <p>Using Python with open source hardware and software to facilitate mathematics instruction amazes me. With a little ingenuity, it's possible to reimagine mathematics education. Each student who participated in our class will receive the Raspberry Pi 400 they worked on to take home and use. They'll have to find a display to connect to, but for a bit over one hundred dollars per unit, we are investing in their future. You can have the same effect in your community if you are willing to donate your time. Public libraries are great spaces for extracurricular activities, and some of the resources I have used as the basis for my classes come from library books. One of those books is <a href="https://opensource.com/education/15/9/review-bryson-payne-teach-your-kids-code" target="_blank">Teach Your Kids to Code</a>. Another is <a href="https://opensource.com/education/13/1/python-for-kids" target="_blank">Python for Kids</a> and <a href="https://github.com/asweigart/simple-turtle-tutorial-for-python/blob/master/simple_turtle_tutorial.md" target="_blank">A Simple Turtle Tutorial</a> by Al Sweigart is available online. We used Raspberry PI 400 kits with VGA monitors and microHDMI to VGA adapters. You could easily adapt this instruction using refurbished Linux laptops, Windows, and/or macOS laptops.</p> </div> <div class="clearfix text-formatted field field--name-field-article-subhead field--type-text-long field--label-hidden field__item"><p>Reimagine math with the help of these open source technologies.</p> </div> <div class="field field--name-field-lead-image field--type-entity-reference field--label-hidden field__item"><article class="media media--type-image media--view-mode-caption"> <div class="field field--name-field-media-image field--type-image field--label-hidden field__item"> <img loading="lazy" src="https://opensource.com/sites/default/files/lead-images/osdc_520x292_opendata_0613mm.png" width="520" height="292" alt="Open data brain" title="Open data brain" /> </div> <div class="field field--name-field-caption field--type-text-long field--label-hidden caption field__item"><span class="caption__byline">Image by: </span><p>Opensource.com </p> </div> </article> </div> <div class="field field--name-field-tags field--type-entity-reference field--label-hidden field__items"> <div class="field__item"><a href="https://opensource.com/tags/python" hreflang="en">Python</a></div> <div class="field__item"><a href="https://opensource.com/tags/raspberry-pi" hreflang="en">Raspberry Pi</a></div> </div> <div class="hidden field field--name-field-listicle-title field--type-string field--label-hidden field__item">What to read next</div> <div class="field field--name-field-default-license field--type-list-string field--label-hidden field__item"><a rel="license" href="http://creativecommons.org/licenses/by-sa/4.0/"> <img alt="Creative Commons License" src="https://opensource.com/themes/osdc/assets/img/cc-by-sa-4.png" title="This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License." /></a>This work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.</div> <section id="comments" class="field field--name-field-comments field--type-comment field--label-hidden comment-wrapper"> <div class="comments__count"> <div class="login"><a href="https://opensource.com/user/register?absolute=1">Register</a> or <a href="https://opensource.com/user/login?current=/rss.xml&absolute=1">Login</a> to post a comment.</div> </div> </section> </div> <footer> <span class="fecha">en <a target="_blank" href="https://opensource.com/"> Opensource.com </a> 12/08/22 04:00 </span> </footer> </article> </section> <section id="hacker-news" class=""> <header> <h3 class="subrrayado">Hacker News</h3> <span class="subtitulo"> <a target="_blank" href="https://news.ycombinator.com/">https://news.ycombinator.com/</a> [<a class="categoria miscelánea" href="?categoria=miscelánea">miscelánea</a>] </span> </header> <article id="autodesk-criticised-by-35-named-architects-2020"> <header> <h4> <a target="_BLANK" href="http://extranetevolution.com/2020/07/autodesk-criticism-extends/">Autodesk criticised by 35 named architects (2020)</a> <span class="anchor"> <a id="id-2_0" href="#autodesk-criticised-by-35-named-architects-2020">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446907">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 01:30 </span> </footer> </article> <article id="ceo-shadow-program"> <header> <h4> <a target="_BLANK" href="https://about.gitlab.com/handbook/ceo/shadow/">CEO Shadow Program</a> <span class="anchor"> <a id="id-2_1" href="#ceo-shadow-program">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445192">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 20:29 </span> </footer> </article> <article id="why-starcraft-crashed-frequently-during-development"> <header> <h4> <a target="_BLANK" href="https://www.codeofhonor.com/blog/tough-times-on-the-road-to-starcraft">Why StarCraft crashed frequently during development</a> <span class="anchor"> <a id="id-2_2" href="#why-starcraft-crashed-frequently-during-development">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446653">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 00:34 </span> </footer> </article> <article id="selftaught-ai-shows-similarities-to-how-the-brain-works"> <header> <h4> <a target="_BLANK" href="https://www.quantamagazine.org/self-taught-ai-shows-similarities-to-how-the-brain-works-20220811/">Self-taught AI shows similarities to how the brain works</a> <span class="anchor"> <a id="id-2_3" href="#selftaught-ai-shows-similarities-to-how-the-brain-works">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446771">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 00:58 </span> </footer> </article> <article id="improving-postgres-text-search-speed"> <header> <h4> <a target="_BLANK" href="https://www.charityapi.org/post/improving-postgres-text-search-speed-7x-on-millions-of-records">Improving Postgres text search speed</a> <span class="anchor"> <a id="id-2_4" href="#improving-postgres-text-search-speed">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445780">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 21:51 </span> </footer> </article> <article id="local-simulation-feature-to-be-removed-from-all-autodesk-fusion-360-versions"> <header> <h4> <a target="_BLANK" href="https://knowledge.autodesk.com/support/fusion-360/learn-explore/caas/sfdcarticles/sfdcarticles/Updates-to-the-Fusion-360-Simulation-Extension.html">Local simulation feature to be removed from all Autodesk Fusion 360 versions</a> <span class="anchor"> <a id="id-2_5" href="#local-simulation-feature-to-be-removed-from-all-autodesk-fusion-360-versions">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445203">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 20:31 </span> </footer> </article> <article id="the-zoom-installer-let-a-researcher-hack-his-way-to-root-access-on-macos"> <header> <h4> <a target="_BLANK" href="https://www.theverge.com/2022/8/12/23303411/zoom-defcon-root-access-privilege-escalation-hack-patrick-wardle">The Zoom installer let a researcher hack his way to root access on macOS</a> <span class="anchor"> <a id="id-2_6" href="#the-zoom-installer-let-a-researcher-hack-his-way-to-root-access-on-macos">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32447339">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 03:05 </span> </footer> </article> <article id="zellij-a-terminal-workspace-with-batteries-included"> <header> <h4> <a target="_BLANK" href="https://zellij.dev/">Zellij: A terminal workspace with batteries included</a> <span class="anchor"> <a id="id-2_7" href="#zellij-a-terminal-workspace-with-batteries-included">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32444564">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 19:11 </span> </footer> </article> <article id="objectives-architectureoriented-language-based-on-smalltalk-and-objectivec"> <header> <h4> <a target="_BLANK" href="http://objective.st/">Objective-S: architecture-oriented language based on Smalltalk and Objective-C</a> <span class="anchor"> <a id="id-2_8" href="#objectives-architectureoriented-language-based-on-smalltalk-and-objectivec">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32444300">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 18:45 </span> </footer> </article> <article id="why-should-i-have-written-zeromq-in-c-not-c++-2012"> <header> <h4> <a target="_BLANK" href="https://250bpm.com/blog:4/">Why should I have written ZeroMQ in C, not C++ (2012)</a> <span class="anchor"> <a id="id-2_9" href="#why-should-i-have-written-zeromq-in-c-not-c++-2012">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445394">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 20:57 </span> </footer> </article> <article id="1959-santa-susana-meltdown"> <header> <h4> <a target="_BLANK" href="https://www.kcrw.com/news/shows/greater-la/santa-susana">1959 Santa Susana meltdown</a> <span class="anchor"> <a id="id-2_10" href="#1959-santa-susana-meltdown">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445253">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 20:37 </span> </footer> </article> <article id="the-bay-areas-lost-streetcars"> <header> <h4> <a target="_BLANK" href="https://sfstreetcars.co/">The Bay Area's Lost Streetcars</a> <span class="anchor"> <a id="id-2_11" href="#the-bay-areas-lost-streetcars">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32447098">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 02:06 </span> </footer> </article> <article id="cancer-in-the-cold"> <header> <h4> <a target="_BLANK" href="https://www.science.org/content/blog-post/cancer-cold">Cancer in the Cold</a> <span class="anchor"> <a id="id-2_12" href="#cancer-in-the-cold">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32440688">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 13:17 </span> </footer> </article> <article id="logistics-how-did-they-do-it-part-iii-on-the-move"> <header> <h4> <a target="_BLANK" href="https://acoup.blog/2022/08/12/collections-logistics-how-did-they-do-it-part-iii-on-the-move/">Logistics, How Did They Do It, Part III: On the Move</a> <span class="anchor"> <a id="id-2_13" href="#logistics-how-did-they-do-it-part-iii-on-the-move">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32440479">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 13:00 </span> </footer> </article> <article id="superlattices-could-make-bulky-capacitors-obsolete"> <header> <h4> <a target="_BLANK" href="https://spectrum.ieee.org/antiferroelectric">Superlattices Could Make Bulky Capacitors Obsolete</a> <span class="anchor"> <a id="id-2_14" href="#superlattices-could-make-bulky-capacitors-obsolete">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446340">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 23:18 </span> </footer> </article> <article id="subreply"> <header> <h4> <a target="_BLANK" href="https://subreply.com/discover">Subreply</a> <span class="anchor"> <a id="id-2_15" href="#subreply">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445450">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 21:05 </span> </footer> </article> <article id="intel-286-secrets-ice-mode-and-f1-0f-04"> <header> <h4> <a target="_BLANK" href="https://rep-lodsb.mataroa.blog/blog/intel-286-secrets-ice-mode-and-f1-0f-04/">Intel 286 secrets: ICE mode and F1 0F 04</a> <span class="anchor"> <a id="id-2_16" href="#intel-286-secrets-ice-mode-and-f1-0f-04">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32443389">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 17:17 </span> </footer> </article> <article id="nsas-warrantless-wiretaps-2012"> <header> <h4> <a target="_BLANK" href="https://www.nerdylorrin.net/jerry/politics/Warrantless/WarrantlessINTRO.html">NSA's Warrantless Wiretaps (2012)</a> <span class="anchor"> <a id="id-2_17" href="#nsas-warrantless-wiretaps-2012">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32443521">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 17:31 </span> </footer> </article> <article id="how-to-get-a-phd-in-mathematics-in-a-timely-fashion-pdf"> <header> <h4> <a target="_BLANK" href="https://sites.math.washington.edu/~billey/advice/timely.fashion.pdf">How to Get a PhD in Mathematics in a Timely Fashion [pdf]</a> <span class="anchor"> <a id="id-2_18" href="#how-to-get-a-phd-in-mathematics-in-a-timely-fashion-pdf">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446693">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 00:42 </span> </footer> </article> <article id="show-hn-i-will-now-send-this-to-beginner-programmers"> <header> <h4> <a target="_BLANK" href="https://headlinedev.xyz/2022/08/12/how-to-learn-to-program.html">Show HN: I will now send this to beginner programmers</a> <span class="anchor"> <a id="id-2_19" href="#show-hn-i-will-now-send-this-to-beginner-programmers">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32446882">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 13/08/22 01:24 </span> </footer> </article> <article id="us-navy-radio-communications-a€“-1950s-and-1960s"> <header> <h4> <a target="_BLANK" href="https://www.navy-radio.com/">US Navy Radio Communications – 1950s and 1960s</a> <span class="anchor"> <a id="id-2_20" href="#us-navy-radio-communications-a€“-1950s-and-1960s">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32445260">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 20:38 </span> </footer> </article> <article id="study-finds-link-between-forever-chemicals-in-cookware-and-liver-cancer"> <header> <h4> <a target="_BLANK" href="https://www.insider.com/study-confirms-link-between-forever-chemicals-and-liver-cancer-risk-2022-8">Study finds link between 'forever chemicals' in cookware and liver cancer</a> <span class="anchor"> <a id="id-2_21" href="#study-finds-link-between-forever-chemicals-in-cookware-and-liver-cancer">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32438368">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 10:32 </span> </footer> </article> <article id="fusion-turns-up-the-heat"> <header> <h4> <a target="_BLANK" href="https://physics.aps.org/articles/v15/67">Fusion Turns Up the Heat</a> <span class="anchor"> <a id="id-2_22" href="#fusion-turns-up-the-heat">#</a> </span> </h4> </header> <div class="content"> <a href="https://news.ycombinator.com/item?id=32444340">Comments</a> </div> <footer> <span class="fecha">en <a target="_blank" href="https://news.ycombinator.com/"> Hacker News </a> 12/08/22 18:49 </span> </footer> </article> </section> <section id="open-source-for-you" class=""> <header> <h3 class="subrrayado">Open Source For You</h3> <span class="subtitulo"> <a target="_blank" href="https://www.opensourceforu.com/">https://www.opensourceforu.com/</a> [] </span> </header> <article id="using-knime-to-understand-the-impact-of-covid-19"> <header> <h4> <a target="_BLANK" href="https://www.opensourceforu.com/2022/08/using-knime-to-understand-the-impact-of-covid-19/">Using KNIME to Understand the Impact of Covid 19</a> <span class="anchor"> <a id="id-3_0" href="#using-knime-to-understand-the-impact-of-covid-19">#</a> </span> </h4> </header> <div class="content"> <div> <a href="https://www.opensourceforu.com/2022/08/using-knime-to-understand-the-impact-of-covid-19/"><img title="Using-KNIME-to-Understand-the-Impact-of-Covid-19" src="" alt="Using KNIME to Understand the Impact of Covid 19" width="700" height="480" /></a> </div> <p> KNIME (Konstanz Information Miner) is free, open source software being used in data science. It makes understanding data, and designing data science workflows and reusable components, easy for everyone. This article implements a clustering algorithm through KNIME for the Covid 19 data set to assess the rate of recovery from the virus in the country. […]</p> <p>The post <a rel="nofollow" href="https://www.opensourceforu.com/2022/08/using-knime-to-understand-the-impact-of-covid-19/">Using KNIME to Understand the Impact of Covid 19</a> appeared first on <a rel="nofollow" href="https://www.opensourceforu.com">Open Source For You</a>.</p> </div> <footer> <span class="fecha">en <a target="_blank" href="https://www.opensourceforu.com/"> Open Source For You </a> 12/08/22 08:09 </span> </footer> </article> </section> </main> <!-- cierra .column-75 --> </div> <!-- cierra .row --> <footer> Universidad Nacional del las Artes <br> Área Transdepartamental de Artes Multimediales <br> Laboratorio de Software Libre </footer> <!-- jQuery --> <script src="https://code.jquery.com/jquery-2.2.3.min.js" integrity="sha256-a23g1Nt4dtEYOj7bR+vTu7+T8VP13humZFBJNIYoEJo=" crossorigin="anonymous"> </script> <!-- jquery.pin --> <script src="https://cdn.jsdelivr.net/jquery.pin/1.0.3/jquery.pin.min.js"> </script> <script> $(".pinned").pin({containerSelector: ".row"}); </script> </body> </html>