General refactor of structure of documentation and more refs

ryukinix · ryukinix · commit fd70a398f564 · 2018-02-11T17:16:47.000-03:00
+ Info about John McCarthy
+ Oficial website of Common Lisp
+ Guide of Exploration of Common Lisp REPL
+ List of Awesome-CL softwares
+ List of Awesome-CL frameworks and tools
+ Brief description about Emacs, Quicklisp and SLIME
diff --git a/index.html b/index.html
@@ -4,7 +4,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
 <head>
 <title>Common Lisp Brasil</title>
-<!-- 2018-02-11 Sun 16:18 -->
+<!-- 2018-02-11 Sun 17:13 -->
 <meta  http-equiv="Content-Type" content="text/html;charset=utf-8" />
 <meta  name="generator" content="Org-mode" />
 <meta  name="author" content="Manoel Vilela, Lucas Vieira" />
@@ -149,16 +149,22 @@ <h2>Table of Contents</h2>
 <li><a href="#sec-1-1">1.1. O que é Common Lisp?</a></li>
 </ul>
 </li>
-<li><a href="#sec-2">2. Links de Aprendizado</a>
+<li><a href="#sec-2">2. Links de Aprendizado sobre Common Lisp</a>
 <ul>
-<li><a href="#sec-2-1">2.1. Material sobre Common Lisp</a></li>
-<li><a href="#sec-2-2">2.2. Configuração do Emacs</a></li>
-<li><a href="#sec-2-3">2.3. Configuração do Quicklisp</a></li>
-<li><a href="#sec-2-4">2.4. Configuração do SLIME</a></li>
+<li><a href="#sec-2-1">2.1. Apresentação</a></li>
+<li><a href="#sec-2-2">2.2. Documentação e tutoriais</a></li>
+<li><a href="#sec-2-3">2.3. Livros</a></li>
 </ul>
 </li>
-<li><a href="#sec-3">3. Projetos e Repositórios Relevantes</a></li>
-<li><a href="#sec-4">4. Apêndice: Mais Links e <i>Off-topic</i></a></li>
+<li><a href="#sec-3">3. Tooling</a>
+<ul>
+<li><a href="#sec-3-1">3.1. Emacs</a></li>
+<li><a href="#sec-3-2">3.2. Quicklisp</a></li>
+<li><a href="#sec-3-3">3.3. SLIME</a></li>
+</ul>
+</li>
+<li><a href="#sec-4">4. Projetos</a></li>
+<li><a href="#sec-5">5. Apêndice: Referências amplas</a></li>
 </ul>
 </div>
 </div>
@@ -180,35 +186,67 @@ <h2 id="sec-1"><span class="section-number-2">1</span> Conceitos e Fundamentos</
 <h3 id="sec-1-1"><span class="section-number-3">1.1</span> O que é Common Lisp?</h3>
 <div class="outline-text-3" id="text-1-1">
 <p>
-Common Lisp é um dos muitos dialetos da linguagem Lisp.  Os Lisps
-(abreviação de List Processor, processador de listas) têm uma sintaxe
-singular baseada no uso, principalmente, de parênteses, que delimitam
-listas de símbolos, que podem ou não estarem associados a valores e/ou
-procedimentos.  Nos Lisps, há a peculiaridade de existir uma linha
-muito tênue de separação entre dados e procedimentos, quando seu
-código é produzido; na realidade, é possível produzir código a partir
-de dados e vice-versa.  Esta família de linguagens foi desenhada para
+Common Lisp é um dos muitos dialetos da linguagem Lisp. Dialetos Lisp
+(abreviação de <b><b>LISt Processing</b></b>, processamento de listas) têm uma
+sintaxe singular baseada no uso de parênteses para denotar de
+símbolos, que podem ou não estarem associados a valores e/ou
+procedimentos. Nos Lisps, há a peculiaridade de existir uma linha
+muito tênue de separação entre dados e procedimentos quando seu código
+é produzido (na realidade, é possível produzir código a partir de
+dados e vice-versa).
+</p>
+
+<p>
+Esta família de linguagens foi desenhada para
 abstrair a complexidade do hardware de um computador, criando uma
 interface para que um humano possa se comunicar de maneira expressiva
-com a máquina.
+com a máquina. O primeiro Lisp denotado historicamente por <a href="https://pt.wikipedia.org/wiki/Lisp">LISP</a> foi
+criado por <a href="https://pt.wikipedia.org/wiki/John_McCarthy">John McCarthy</a> em 1958 nos laboratórios do MIT, USA.
 </p>
 </div>
 </div>
 </div>
 
 
 <div id="outline-container-sec-2" class="outline-2">
-<h2 id="sec-2"><span class="section-number-2">2</span> Links de Aprendizado</h2>
+<h2 id="sec-2"><span class="section-number-2">2</span> Links de Aprendizado sobre Common Lisp</h2>
 <div class="outline-text-2" id="text-2">
 </div><div id="outline-container-sec-2-1" class="outline-3">
-<h3 id="sec-2-1"><span class="section-number-3">2.1</span> Material sobre Common Lisp</h3>
+<h3 id="sec-2-1"><span class="section-number-3">2.1</span> Apresentação</h3>
 <div class="outline-text-3" id="text-2-1">
 <ul class="org-ul">
+<li><a href="http://lisp-lang.org/">Site oficial de Common Lisp</a>, apresentação sobre a linguagem e seu poder.
+</li>
+<li><a href="https://github.com/CodyReichert/awesome-cl">Awesome-CL</a>, uma lista imensa sobre frameworks e ferramentas para
+Common Lisp.
+</li>
+<li><a href="http://www.lisperati.com/casting.html">Lisperati Casting</a>, uma história em quadrinhos sobre a magia que é
+programar em Lisp.
+</li>
+</ul>
+</div>
+</div>
+
+<div id="outline-container-sec-2-2" class="outline-3">
+<h3 id="sec-2-2"><span class="section-number-3">2.2</span> Documentação e tutoriais</h3>
+<div class="outline-text-3" id="text-2-2">
+<ul class="org-ul">
 <li><a href="http://www.lispworks.com/documentation/HyperSpec/Front/">Common Lisp Hyperspec</a>
   Sua primeira parada ao pesquisar por documentação de Common Lisp. <a href="http://clhs.lisp.se/">(Mirror)</a>
 </li>
 <li><a href="https://www.cliki.net/">CLiki, a Wiki de Common Lisp</a>
 </li>
+<li><a href="http://bnmcgn.github.io/lisp-guide/lisp-exploration.html">Common Lisp REPL Exploration Guide</a>, um guia interessantíssimo sobre
+a exploração de Common Lisp pelo <a href="https://en.wikipedia.org/wiki/Read%25E2%2580%2593eval%25E2%2580%2593print_loop">REPL</a>.
+</li>
+</ul>
+</div>
+</div>
+
+<div id="outline-container-sec-2-3" class="outline-3">
+<h3 id="sec-2-3"><span class="section-number-3">2.3</span> Livros</h3>
+<div class="outline-text-3" id="text-2-3">
+<ul class="org-ul">
 <li>Common Lisp: A Gentle Introduction to Symbolic Computation, por David S. Touretsky
 <ul class="org-ul">
 <li>[Amazon] <a href="https://www.amazon.com.br/Common-LISP-Introduction-Computation-Engineering-ebook/dp/B00IZUEG1G/">Livro físico</a>
@@ -232,10 +270,19 @@ <h3 id="sec-2-1"><span class="section-number-3">2.1</span> Material sobre Common
 </ul>
 </div>
 </div>
+</div>
+
+<div id="outline-container-sec-3" class="outline-2">
+<h2 id="sec-3"><span class="section-number-2">3</span> Tooling</h2>
+<div class="outline-text-2" id="text-3">
+</div><div id="outline-container-sec-3-1" class="outline-3">
+<h3 id="sec-3-1"><span class="section-number-3">3.1</span> Emacs</h3>
+<div class="outline-text-3" id="text-3-1">
+<p>
+Emacs é o melhor editor de texto em consenso para se programar em
+Common Lisp.
+</p>
 
-<div id="outline-container-sec-2-2" class="outline-3">
-<h3 id="sec-2-2"><span class="section-number-3">2.2</span> Configuração do Emacs</h3>
-<div class="outline-text-3" id="text-2-2">
 <ul class="org-ul">
 <li>[Inglês] Mini-manual do Emacs, por <a href="https://github.com/tuhdo">tuhdo</a>
 <ul class="org-ul">
@@ -251,12 +298,19 @@ <h3 id="sec-2-2"><span class="section-number-3">2.2</span> Configuração do Ema
 </div>
 </div>
 
-<div id="outline-container-sec-2-3" class="outline-3">
-<h3 id="sec-2-3"><span class="section-number-3">2.3</span> Configuração do Quicklisp</h3>
-<div class="outline-text-3" id="text-2-3">
+<div id="outline-container-sec-3-2" class="outline-3">
+<h3 id="sec-3-2"><span class="section-number-3">3.2</span> Quicklisp</h3>
+<div class="outline-text-3" id="text-3-2">
+<p>
+Quicklisp é o gerenciador de pacote (sistemas nos jargões de CL),
+muito útil para integrar sua aplicação usando pacotes de terceiro.
+</p>
+
 <ul class="org-ul">
 <li>[Inglês] <a href="https://www.quicklisp.org/beta/">Site oficial do Quicklisp</a>
 </li>
+<li>[Inglês] <a href="https://lispcookbook.github.io/cl-cookbook/getting-started.html">Lisp CookBook Getting Started (Quicklisp também incluso)</a>
+</li>
 <li>[Inglês] <a href="https://www.xach.com/lisp/quickproject/">Quickproject: crie o esqueleto de um projeto de Common Lisp</a>
 
 <p>
@@ -268,9 +322,15 @@ <h3 id="sec-2-3"><span class="section-number-3">2.3</span> Configuração do Qui
 </div>
 </div>
 
-<div id="outline-container-sec-2-4" class="outline-3">
-<h3 id="sec-2-4"><span class="section-number-3">2.4</span> Configuração do SLIME</h3>
-<div class="outline-text-3" id="text-2-4">
+<div id="outline-container-sec-3-3" class="outline-3">
+<h3 id="sec-3-3"><span class="section-number-3">3.3</span> SLIME</h3>
+<div class="outline-text-3" id="text-3-3">
+<p>
+SLIME significa <i>SUPERIOR LISP INTERACTION MODE for EMACS</i>. É uma
+das coisas mais fascinante que se faz Common Lisp uma linguagem tão
+produtiva e o Emacs ser seu editor ideal.
+</p>
+
 <ul class="org-ul">
 <li>[Inglês] <a href="https://astraybi.wordpress.com/2015/08/02/how-to-install-slimesbclquicklisp-into-emacs/">Instalando SLIME + SBCL + Quicklisp no Emacs</a>, por Astray<sub>BI</sub>
 </li>
@@ -286,9 +346,9 @@ <h3 id="sec-2-4"><span class="section-number-3">2.4</span> Configuração do SLI
 </div>
 </div>
 
-<div id="outline-container-sec-3" class="outline-2">
-<h2 id="sec-3"><span class="section-number-2">3</span> Projetos e Repositórios Relevantes</h2>
-<div class="outline-text-2" id="text-3">
+<div id="outline-container-sec-4" class="outline-2">
+<h2 id="sec-4"><span class="section-number-2">4</span> Projetos</h2>
+<div class="outline-text-2" id="text-4">
 <ul class="org-ul">
 <li><a href="https://next-browser.github.io/">nEXT, um browser totalmente escrito em Common Lisp</a>
 </li>
@@ -309,15 +369,18 @@ <h2 id="sec-3"><span class="section-number-2">3</span> Projetos e Repositórios
 </p>
 </li>
 
-<li><a href="http://xzpeter.org/starwar/"><code>starwar</code>, um jogo feito em Common Lisp usando SDL</a> (<a href="https://github.com/xzpeter/starwar">Repositório</a>) (<a href="https://github.com/commonlispbr/starwar">Fork da nossa comunidade</a>)
+<li><a href="http://xzpeter.org/starwar/"><code>starwar</code>, um jogo feito em Common Lisp usando SDL</a> (<a href="https://github.com/xzpeter/starwar">Repositório</a>)
+(<a href="https://github.com/commonlispbr/starwar">Fork da nossa comunidade</a>)
+</li>
+<li><a href="https://github.com/azzamsa/awesome-cl-software">Awesome-CL-software</a>, uma lista sobre aplicações feitas em Common Lisp!
 </li>
 </ul>
 </div>
 </div>
 
-<div id="outline-container-sec-4" class="outline-2">
-<h2 id="sec-4"><span class="section-number-2">4</span> Apêndice: Mais Links e <i>Off-topic</i></h2>
-<div class="outline-text-2" id="text-4">
+<div id="outline-container-sec-5" class="outline-2">
+<h2 id="sec-5"><span class="section-number-2">5</span> Apêndice: Referências amplas</h2>
+<div class="outline-text-2" id="text-5">
 <ul class="org-ul">
 <li>[Inglês] Build Your Own Lisp, por Daniel Holder
 <ul class="org-ul">
@@ -348,7 +411,7 @@ <h2 id="sec-4"><span class="section-number-2">4</span> Apêndice: Mais Links e <
 <div id="postamble" class="status">
 <p class="date">Date: <span class="timestamp-wrapper"><span class="timestamp">&lt;2018-02-10 Sat&gt;</span></span></p>
 <p class="author">Author: Manoel Vilela, Lucas Vieira</p>
-<p class="date">Created: 2018-02-11 Sun 16:18</p>
+<p class="date">Created: 2018-02-11 Sun 17:13</p>
 <p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 25.3.1 (<a href="http://orgmode.org">Org</a> mode 8.2.10)</p>
 <p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
 </div>
diff --git a/index.org b/index.org
@@ -15,25 +15,41 @@ issue no repositório desta página]]. :)/
 * Conceitos e Fundamentos
 ** O que é Common Lisp?
 
-Common Lisp é um dos muitos dialetos da linguagem Lisp.  Os Lisps
-(abreviação de List Processor, processador de listas) têm uma sintaxe
-singular baseada no uso, principalmente, de parênteses, que delimitam
-listas de símbolos, que podem ou não estarem associados a valores e/ou
-procedimentos.  Nos Lisps, há a peculiaridade de existir uma linha
-muito tênue de separação entre dados e procedimentos, quando seu
-código é produzido; na realidade, é possível produzir código a partir
-de dados e vice-versa.  Esta família de linguagens foi desenhada para
+Common Lisp é um dos muitos dialetos da linguagem Lisp. Dialetos Lisp
+(abreviação de **LISt Processing**, processamento de listas) têm uma
+sintaxe singular baseada no uso de parênteses para denotar de
+símbolos, que podem ou não estarem associados a valores e/ou
+procedimentos. Nos Lisps, há a peculiaridade de existir uma linha
+muito tênue de separação entre dados e procedimentos quando seu código
+é produzido (na realidade, é possível produzir código a partir de
+dados e vice-versa).
+
+Esta família de linguagens foi desenhada para
 abstrair a complexidade do hardware de um computador, criando uma
 interface para que um humano possa se comunicar de maneira expressiva
-com a máquina.
+com a máquina. O primeiro Lisp denotado historicamente por [[https://pt.wikipedia.org/wiki/Lisp][LISP]] foi
+criado por [[https://pt.wikipedia.org/wiki/John_McCarthy][John McCarthy]] em 1958 nos laboratórios do MIT, USA.
 
 
-* Links de Aprendizado
-** Material sobre Common Lisp
+* Links de Aprendizado sobre Common Lisp
+** Apresentação
+
+- [[http://lisp-lang.org/][Site oficial de Common Lisp]], apresentação sobre a linguagem e seu poder.
+- [[https://github.com/CodyReichert/awesome-cl][Awesome-CL]], uma lista imensa sobre frameworks e ferramentas para
+  Common Lisp.
+- [[http://www.lisperati.com/casting.html][Lisperati Casting]], uma história em quadrinhos sobre a magia que é
+  programar em Lisp.
+
+** Documentação e tutoriais
 
 - [[http://www.lispworks.com/documentation/HyperSpec/Front/][Common Lisp Hyperspec]]
   Sua primeira parada ao pesquisar por documentação de Common Lisp. [[http://clhs.lisp.se/][(Mirror)]]
 - [[https://www.cliki.net/][CLiki, a Wiki de Common Lisp]]
+- [[http://bnmcgn.github.io/lisp-guide/lisp-exploration.html][Common Lisp REPL Exploration Guide]], um guia interessantíssimo sobre
+  a exploração de Common Lisp pelo [[https://en.wikipedia.org/wiki/Read%25E2%2580%2593eval%25E2%2580%2593print_loop][REPL]].
+
+** Livros
+
 - Common Lisp: A Gentle Introduction to Symbolic Computation, por David S. Touretsky
   - [Amazon] [[https://www.amazon.com.br/Common-LISP-Introduction-Computation-Engineering-ebook/dp/B00IZUEG1G/][Livro físico]]
   - [[https://www.cs.cmu.edu/~dst/LispBook/][Versão online]]
@@ -43,30 +59,43 @@ com a máquina.
   - [Amazon] [[https://www.amazon.com.br/Practical-Common-Lisp-Peter-Seibel/dp/1590592395][Livro físico]]
   - [[http://www.gigamonkeys.com/book/][Versão online]]
 
-** Configuração do Emacs
+* Tooling
+
+** Emacs
+
+Emacs é o melhor editor de texto em consenso para se programar em
+Common Lisp.
 
 - [Inglês] Mini-manual do Emacs, por [[https://github.com/tuhdo][tuhdo]]
   - [[http://tuhdo.github.io/emacs-tutor.html][Parte 1: O Básico]]
   - [[http://tuhdo.github.io/emacs-tutor2.html][Parte 2: Por que parênteses importam]]
   - [[http://tuhdo.github.io/emacs-tutor3.html][Parte 3: Customizando e extendendo o Emacs]]
 
-** Configuração do Quicklisp
+**  Quicklisp
+
+Quicklisp é o gerenciador de pacote (sistemas nos jargões de CL),
+muito útil para integrar sua aplicação usando pacotes de terceiro.
 
 - [Inglês] [[https://www.quicklisp.org/beta/][Site oficial do Quicklisp]]
+- [Inglês] [[https://lispcookbook.github.io/cl-cookbook/getting-started.html][Lisp CookBook Getting Started (Quicklisp também incluso)]]
 - [Inglês] [[https://www.xach.com/lisp/quickproject/][Quickproject: crie o esqueleto de um projeto de Common Lisp]]
 
   Este tutorial é extremamente útil para a criação de projetos
   compatíveis com Quicklisp.
 
-** Configuração do SLIME
+** SLIME
+
+SLIME significa /SUPERIOR LISP INTERACTION MODE for EMACS/. É uma
+das coisas mais fascinante que se faz Common Lisp uma linguagem tão
+produtiva e o Emacs ser seu editor ideal.
 
 - [Inglês] [[https://astraybi.wordpress.com/2015/08/02/how-to-install-slimesbclquicklisp-into-emacs/][Instalando SLIME + SBCL + Quicklisp no Emacs]], por Astray_BI
 - [Inglês] [[https://github.com/quicklisp/quicklisp-slime-helper][Repositório do =quicklisp-slime-helper=]]
 
   Este pacote torna mais fácil a instalação do SLIME, a partir do
   Quicklisp.
 
-* Projetos e Repositórios Relevantes
+* Projetos
 
 - [[https://next-browser.github.io/][nEXT, um browser totalmente escrito em Common Lisp]]
 - [[https://github.com/adolenc/cl-neovim][=cl-neovim=, cliente de Common Lisp para Neovim]]
@@ -79,9 +108,11 @@ com a máquina.
   Neste repositório, foram feitos, em Common Lisp, os mini-jogos
   =cl-2048=, =cl-snake= e =dagarden=.
 
-- [[http://xzpeter.org/starwar/][=starwar=, um jogo feito em Common Lisp usando SDL]] ([[https://github.com/xzpeter/starwar][Repositório]]) ([[https://github.com/commonlispbr/starwar][Fork da nossa comunidade]])
+- [[http://xzpeter.org/starwar/][=starwar=, um jogo feito em Common Lisp usando SDL]] ([[https://github.com/xzpeter/starwar][Repositório]])
+  ([[https://github.com/commonlispbr/starwar][Fork da nossa comunidade]])
+- [[https://github.com/azzamsa/awesome-cl-software][Awesome-CL-software]], uma lista sobre aplicações feitas em Common Lisp!
 
-* Apêndice: Mais Links e /Off-topic/
+* Apêndice: Referências amplas
 
 - [Inglês] Build Your Own Lisp, por Daniel Holder
   - [Amazon] [[https://www.amazon.com.br/Build-Your-Own-Lisp-English-ebook/dp/B00ONV8CNO/][Livro físico]]
