Prima versione

Author: ercasta

.gitignore

@@ -0,0 +1,2 @@
+_build
+extensions/__pycache__

LICENSE.txt

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = ScopriamoGodot
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

Makefile

@@ -1,2 +1,10 @@
-# Scopriamo-Godot
-Una guida introduttiva a Godot per chi conosce Scratch
+# Scopriamo Godot!
+
+Questo repository contiene i sorgenti della guida "Scopriamo Godot"
+
+
+## Licenza
+
+Il materiale è distribuito sotto licenza Creative Commons Attribution 3.0 Unported license ([CC BY 3.0](https://creativecommons.org/licenses/by/3.0/)) . Lo script pygment gdscript.py proviene dal ([repository originale di Godot Docs] (https://github.com/godotengine/godot-docs/) by "Juan Linietsky, Ariel Manzur and the Godot community" 
+
+Vedi [LICENSE.txt](/LICENSE.txt) per dettagli

README.md

@@ -0,0 +1,20 @@
+{# Import the theme's layout. #}
+{% extends "!layout.html" %}
+
+{% block extrahead %}
+
+<script type="text/javascript">
+        $(document).ready(function(){   
+            $('div.admonition.hint p.first.admonition-title').text("Soluzione (clicca per mostrare)")
+            $('div.admonition.hint p.first.admonition-title').nextAll('p').slideToggle(0)
+            $('div.admonition.hint p.first.admonition-title').nextAll('div.highlight-gdscript').slideToggle(0)
+            $('div.admonition.hint p.first.admonition-title').click(function(){   
+                $(this).toggleClass('active');      
+                $(this).nextAll('p').slideToggle(1);
+                $(this).nextAll('div.highlight-gdscript').slideToggle(1)
+            });
+        });
+</script>
+
+{{ super() }}
+{% endblock %}

_templates/layout.html

@@ -0,0 +1,129 @@
+.. _ComeSiFa:
+
+**********************
+Come si fa
+**********************
+
+Questa sezione spiega come fare delle cose specifiche in Godot. 
+
+
+Fare qualcosa se un tasto è premuto
+================================================
+
+Per fare qualcosa quando si preme un tasto, bisogna innanzitutto configurare un'azione nel menu ``Progetto->Impostazioni Progetto->Mappa Input``:
+
+.. figure:: img/Mappa_Input.png
+   :alt: Mappa Input
+
+Si scrive il nome dell'azione e si preme su ``Aggiungi``:
+
+.. figure:: img/aggiungi_azione.png
+   :alt: Aggiungi Azione
+
+Poi si specifica il tasto:
+
+.. figure:: img/aggiungi_tasto.png
+   :alt: Aggiungi Tasto
+
+.. figure:: img/premi_tasto.png
+   :alt: Premi un Tasto
+
+Infine, si può usare l'azione nel codice: ::
+
+    var colpisci = Input.is_action_pressed('colpisci')
+    if colpisci:
+        # fai qualcosa
+
+.. IMPORTANT:: ci sono due funzioni simili: ``Input.is_action_pressed`` e ``Input.is_action_just_pressed``. La prima 
+    serve per controllare se il tasto è premuto. La seconda per controllare se è stato **appena** premuto. La prima funzione va 
+    bene ad esempio per i tasti freccia, perchè finchè il tasto è premuto, il personaggio si sposta. La seconda va bene per quando
+    si attacca: ogni volta che viene premuto il tasto, il personaggio attacca 
+
+
+Animazioni!
+================================================
+
+In Godot per fare le animazioni si usano i Nodi di tipo `AnimatedSprite`. 
+
+Ad esempio per il gioco del Cavaliere Miaogico, usiamo il nodo `Animazioni`:
+
+.. figure:: img/animazione/nodo_animazione.png
+   :alt: Il nodo `Animazioni`
+
+Cliccando sul nodo, possiamo vedere che una delle sue proprietà si chiama `Frames`. I `Frames` sono un pò come i costumi di Scratch, ma possono essere raggruppati in animazioni diverse. Cliccando sulla parte bassa della finestra di Godot, sulla parola `SpriteFrames`, vengono visualizzate tutte le animazioni presenti.
+Ad esempio per il gioco del Cavaliere Miaogico, ci sono animazioni diverse per l'attacco e la camminata; ognuna ha i suoi costumi:
+
+.. figure:: img/animazione/frames.png
+   :alt: Il frames
+
+Per far partire un'animazione usiamo le funzioni `play()` e `stop()`. Ad esempio, nello script del Personaggio: ::
+
+    $Animazioni.play("camminata")
+    $Animazioni.set_flip_h(true)
+
+.. NOTE:: la funzione `set_flip_h(true)` serve per riflettere orizzontalmente l'animazione. Serve per poter usare la stessa animazione sia quando il Personaggio è rivolto verso destra che verso sinistra.
+
+Aggiungere una "Camera"
+================================================
+
+La ``Camera`` serve per inquadrare sempre il personaggio anche se il livello è più grande dello schermo
+
+Per prima cosa bisogna aggiungere un nodo ``Camera2d`` al personaggio:
+
+.. figure:: img/camera/camera.png
+   :alt: Nodo Camera2d
+
+Poi si configurano le opzioni. ``Current`` va impostato a ``On`` se si vuole che la ``Camera`` sia attiva. I ``Limiti`` servono per fare in modo che la ``Camera`` non inquadri mai oltre il bordo del livello. In questo esempio sono impostati a mano:
+
+.. figure:: img/camera/camera_opzioni.png
+   :alt: Opzioni Camera
+
+
+Disegnare il livello
+================================================
+
+Per disegnare il livello bisogna agire sul nodo `TileMap`(letteralmente vuol dire "mappa di piastrelle"):
+
+.. figure:: img/tilemap/nodo.png
+   :alt: Nodo TileMap
+
+Selezionando il nodo `TileMap` appaiono tante piastrelle diverse utilizzabili
+
+.. NOTE:: le piastrelle le abbiamo preparate noi. Per prepararle bisogna fare un pò di passaggi, che spiegheremo in un altro "come si fa". 
+
+.. figure:: img/tilemap/seleziona-tile.png
+   :alt: Seleziona Piastrella
+
+Dopo aver selezionato una piastrella:
+
+- con il tastro sinistro si aggiunge la piastrella al livello
+- con il tasto destro si cancella
+
+il tasto sinistro / destro si possono anche tenere premuti, per essere più veloci.
+
+
+Usare i "segnali"
+================================================
+
+In Godot alcuni nodi hanno la possibilità di mandare dei "segnali", che sono un pò come i messaggi di Scratch.
+In Godot però i messaggi non vengono inviati a tutti gli altri nodi. Bisogna collegarli. Per farlo, bisogna andare nella sezione "Nodo" del nodo. Ad esempio per il gioco del Cavaliere Miaogico, usiamo il nodo `Slash`
+
+.. figure:: img/slash/seleziona_nodo.png
+   :alt: Il nodo `Slash`
+
+Scegliamo il segnale che ci interessa: `body_entered`, che vuol dire che un altro oggetto (in questo caso un nemico) è "entrato" nello slash (o viceversa):
+
+.. figure:: img/slash/segnale.png
+   :alt: Il segnale `body_entered`
+
+E lo colleghiamo a una funzione. Godot è così gentile da creare per noi una funzione con un nome appropriato:
+
+.. figure:: img/slash/metodo.png
+   :alt: La scelta della funzione.
+
+Infine possiamo fare qualcosa nella funzione, ad esempio: ::
+
+    func _on_Slash_body_entered(body):
+        if "Alieno" in body.name:
+            body.morto()
+            queue_free()

come_si_fa.rst

@@ -0,0 +1,190 @@
+# -*- coding: utf-8 -*-
+#
+# Configuration file for the Sphinx documentation builder.
+#
+# This file does only contain a selection of the most common options. For a
+# full list see the documentation:
+# http://www.sphinx-doc.org/en/master/config
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+sys.path.append(os.path.abspath('extensions'))
+extensions = ['gdscript']
+
+from gdscript import GDScriptLexer
+from sphinx.highlighting import lexers
+lexers['gdscript'] = GDScriptLexer()
+
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'Scopriamo Godot'
+copyright = '2019, Antonio Castaldo D\'Ursi - CoderDojo Lissone - CC-BY-3.0'
+author = 'Antonio Castaldo D\'Ursi'
+
+# The short X.Y version
+version = ''
+# The full version, including alpha/beta/rc tags
+release = ''
+
+
+# -- General configuration ---------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.mathjax',
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = 'it'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path .
+exclude_patterns = []
+
+# Pygments (syntax highlighting) style to use
+pygments_style = 'sphinx'
+highlight_language = 'gdscript'
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+#html_theme = 'alabaster'
+html_theme = "sphinx_rtd_theme"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# The default sidebars (for documents that don't match any pattern) are
+# defined by theme itself.  Builtin themes are using these templates by
+# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
+# 'searchbox.html']``.
+#
+# html_sidebars = {}
+
+
+# -- Options for HTMLHelp output ---------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'ScopriamoGodotdoc'
+
+
+# -- Options for LaTeX output ------------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, 'ScopriamoGodot.tex', 'Scopriamo Godot Documentation',
+     'Antonio Castaldo D\'Ursi', 'manual'),
+]
+
+
+# -- Options for manual page output ------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [
+    (master_doc, 'scopriamogodot', 'Scopriamo Godot Documentation',
+     [author], 1)
+]
+
+
+# -- Options for Texinfo output ----------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (master_doc, 'ScopriamoGodot', 'Scopriamo Godot Documentation',
+     author, 'ScopriamoGodot', 'One line description of project.',
+     'Miscellaneous'),
+]
+
+
+# -- Options for Epub output -------------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+epub_author = author
+epub_publisher = author
+epub_copyright = copyright
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ['search.html']
+
+
+# -- Extension configuration -------------------------------------------------

conf.py

@@ -0,0 +1,14 @@
+*****************
+Esercizi
+*****************
+
+In questa sezione ci sono un pò di esercizi:
+
+:ref:`Il Cavaliere Miaogico` : un progetto di base
+
+.. .. include:: esercizi/scratchy/scratchy.rst
+
+
+
+
+