==================
Learning resources
==================

Here are some recommended resources for learning the external things
you need to know as a Lino developer.


Python
======

- `Learn Python The Hard Way <http://learnpythonthehardway.org>`_
  by Zed A. Shaw

- `Code Academy <https://www.codecademy.com/catalog/language/python>`_

- `Dive Into Python <http://www.diveintopython.net>`__ ("Python from
  novice to pro") is a free Python book for experienced programmers.

- `Think Python 2e <http://greenteapress.com/wp/think-python-2e/>`__
  is an introduction to Python programming for beginners.

- Mike Driscoll's `Python 201: A Tutorial on Threads
  <http://www.blog.pythonlibrary.org/2016/07/28/python-201-a-tutorial-on-threads/>`_

- We try to follow the `Django coding style
  <https://docs.djangoproject.com/en/3.1/internals/contributing/writing-code/coding-style/>`__

- `Python Debugging With Pdb
  <https://realpython.com/python-debugging-pdb>`__ by Nathan Jennings.


- (in Estonian: `Programmeerimise õpik <https://programmeerimine.cs.ut.ee>`_)

.. _learning.unix:

Working in a UNIX shell
=======================

- An in-depth exploration of the art of shell scripting: `Advanced
  Bash-Scripting Guide <http://www.tldp.org/LDP/abs/html>`_ by Mendel
  Cooper

- `Bash Cheat sheet
  <https://learncodethehardway.org/unix/bash_cheat_sheet.pdf>`__

- `Bash guide on Greg's wiki <http://mywiki.wooledge.org/BashGuide>`_

- `Steve Parker's shell scripting guide
  <http://steve-parker.org/sh/first.shtml>`_

- `BASH Programming - Introduction HOW-TO
  <http://tldp.org/HOWTO/Bash-Prog-Intro-HOWTO.html>`_ by Mike G

- http://books.goalkicker.com/BashBook/


Sphinx
======

Documentation about Lino is written using `Sphinx <http://sphinx-doc.org>`_.

- `Tutorial <http://sphinx-doc.org/tutorial.html>`_

- You should know how Sphinx works and why we use it to write Lino
  documentation.  See :doc:`/dev/builddocs` for the first steps.

- You might want to use the same blogging system as Luc and to
  document your own contributions to Lino in a :doc:`developer blog
  </dev/devblog>`.



HTML, CSS and Javascript
========================

- `FreeCodeCamp <https://www.freecodecamp.org>`__
- `HTML Tutorial <http://www.w3schools.com/html/>`_
- `CSS Tutorial <http://www.w3schools.com/css/>`_
- `Javascript Tutorial <http://www.w3schools.com/js/>`_

SQL
===

- `SQL Tutorial <http://www.w3schools.com/sql/>`_
- `Udemy's Beginner’s Guide to SQL
  <https://blog.udemy.com/beginners-guide-to-sql/>`__


Git
===

See also :doc:`/dev/git` and :doc:`/dev/request_pull`.

- `Atlassian's Git Tutorial <https://www.atlassian.com/git/tutorials>`__
- `GitHub Help site <https://help.github.com/>`__
- `Udemy Comprehensive Git Guide
  <https://blog.udemy.com/git-tutorial-a-comprehensive-guide/>`__
- `GitKraken <https://www.gitkraken.com>`__ can help to understand things.