Add Greek tutorial

src/doc/el/tutorial/conf.py

@@ -0,0 +1,43 @@
+# nodoctest
+# Sage documentation build configuration file, created by
+# sphinx-quickstart on Thu Aug 21 20:15:55 2008.
+#
+# This file is execfile()d with the current directory set to its containing dir.
+#
+# The contents of this file are pickled, so don't put values in the namespace
+# that aren't pickleable (module imports are okay, they're removed automatically).
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+from sage_docbuild.conf import release
+from sage_docbuild.conf import *  # NOQA
+
+# Add any paths that contain custom static files (such as style sheets),
+# relative to this directory to html_static_path. They are copied after the
+# builtin static files, so a file named "default.css" will overwrite the
+# builtin "default.css". html_common_static_path imported from sage_docbuild.conf
+# contains common paths.
+html_static_path = [] + html_common_static_path
+
+# Add a small edit button.
+html_theme_options.update({
+  'source_edit_link': os.path.join(source_repository, 'blob/develop/src/doc/en/tutorial', '{filename}'),
+})
+
+# General information about the project.
+project = "Tutorial"
+
+# The name for this set of Sphinx documents.
+html_title = project
+html_short_title = project
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = 'sage_tutorial'
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title, author, document class [howto/manual]).
+latex_documents = [
+  ('index', 'sage_tutorial.tex', 'Tutorial',
+   'The Sage Development Team', 'manual'),
+]

src/doc/el/tutorial/index.rst

@@ -0,0 +1,35 @@
+.. Sage documentation master file, created by sphinx-quickstart on Thu Aug 21 20:15:55 2008.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+.. _tutorial:
+
+===================================
+Καλώς ήρθατε στο σεμινάριο του Sage
+===================================
+
+Το Sage είναι δωρεάν λογισμικό μαθηματικών ανοιχτού κώδικα που υποστηρίζει την
+έρευνα και την διδασκαλία στην άλγεβρα, γεωμετρία, θεωρία αριθμών,
+κρυπτογραφία, στους αριθμητικούς υπολογισμούς και σε άλλα σχετικά πεδία. Τόσο
+το μοντέλο ανάπτυξης του Sage, καθώς και η τεχνολογία του, διακρίνονται από μία
+εξαιρετικά μεγάλη έμφαση στην εξωστρέφεια, την κοινότητα, και την συνεργασία:
+κατασκευάζουμε το αυτοκίνητο, δεν επανεφευρίσκουμε τον τροχό. Ο γενικός στόχος
+του Sage είναι να δημιουργήσει μία βιώσιμη, δωρεάν, ανοιχτού κώδικα εναλλακτική
+των Maple, Mathematica, Magma, και MATLAB.
+
+Αυτό το σεμινάριο είναι ο καλύτερος τρόπος για να εξοικειωθείτε με το Sage
+σε λίγη ώρα. Μπορείτε να το διαβάσετε σε εκδόσεις HTML ή PDF ή από το
+σημειωματάριο Sage (κάντε κλικ στην επιλογή ``Help`` και, στη συνέχεια, κάντε
+κλικ στην επιλογή ``Tutorial`` για να διαδράσετε με το σεμινάριο μέσα από το
+Sage).
+
+Το έργο αυτό διατίθεται υπό την άδεια `Creative Commons Attribution-Share Alike
+3.0 License`__.
+
+__ http://creativecommons.org/licenses/by-sa/3.0/
+
+.. toctree::
+   :maxdepth: 2
+
+   introduction
+   interactive_shell

src/doc/el/tutorial/interactive_shell.rst

@@ -0,0 +1,101 @@
+.. _chapter-interactive_shell:
+
+**********************
+Το διαδραστικό κέλυφος
+**********************
+
+Εκκινώντας τον διερμηνέα Sage με την εντολή ``sage``, εκκινείται μία
+τροποποιημένη έκδοση του κελύφους ``IPython``, η οποία εισαγάγει πολλές
+συναρτήσεις και κλάσεις -- έτοιμες προς χρήση.
+
+.. CODE-BLOCK:: text
+
+    ┌────────────────────────────────────────────────────────────────────┐
+    │ SageMath version X.X, Release Date: YYYY-MM-DD                     │
+    │ Using Python X.X.X. Type "help()" for help.                        │
+    └────────────────────────────────────────────────────────────────────┘
+    sage:
+
+Για να εξέλθετε από το Sage πληκτρολογείστε :kbd:`Ctrl+d` (ή ``quit`` ή
+``exit``).
+
+(Αποφύγετε τον τερματισμό μέσω αποστολής σήματος, όπως ``kill -9``,
+καθώς αυτό ενδέχεται να μην τερματίσει κάποιες διεργασίες ή μπορεί να μην
+εκκαθαρίσει προσωρινά αρχεία.)
+
+Χρήσιμες συντομεύσεις και εντολές
+=================================
+
+- ``?`` -- εμφάνιση βοήθειας για κάποια συνάρτηση
+
+- ``??`` -- εμφάνιση πηγαίου κώδικα συνάρτησης
+
+- ``help()`` -- εμφάνιση εγχειριδίου εντολής ή κλάσης (``q`` για έξοδο)
+
+- ``!`` -- χρήση πριν από την εισαγωγή οποιασδήποτε UNIX εντολής
+
+- ``_`` -- τελευταία μη κενή έξοδος
+
+- ``__`` -- προτελευταία μη κενή έξοδος
+
+- ``ih``, ``_oh`` -- λίστα εισόδων και εξόδων των εντολών της συνεδρίας
+
+- :kbd:`Ctrl+r` -- αναζήτηση στις παρελθούσες εντολές
+
+- ``%history`` ή ``%hist`` -- επιστρέφει τη λίστα όλων των προηγουμένων εντολών
+  της τρέχουσας συνεδρίας
+
+- ``%time`` -- προηγείται μίας εντολής και εμφανίζει τον χρόνο εκτέλεσής της
+
+- ``timeit()`` -- εμφάνιση στοιχείων χρόνου εκτέλεση εντολής έπειτα από
+  επαναλαμβανόμενες εκτελέσεις· η εντολή εισάγεται ως συμβολοσειρά (εντός
+  ``""``)
+
+- ``cputime()`` -- εμφανίζει τον χρόνο επεξεργασίας· παράδειγμα [1]_
+
+- ``walltime()`` -- όμοια εντολή με την ``cputime()``, μόνο που μετράει
+  «πραγματικό» χρόνο, όπως θα τον μετρούσε το ρολόι τοίχου σας
+
+- ``%macro`` -- δημιουργία μακροεντολής (συντόμευση για σειρά εντολών)·
+  παράδειγμα [2]_
+
+- ``logstart`` -- αρχή καταγραφής συνεδρίας εντολών εισόδου· φόρτωση και
+  επανεκτέλεση μέσω της εντολής ``load()``
+
+- ``save_session()`` -- αποθήκευση συνεδρίας
+
+- ``load_session()`` -- φόρτωση συνεδρίας
+
+Μερικά παραδείγματα
+===================
+
+.. [1] ``cputime()``
+
+.. skip
+
+::
+
+    sage: t = cputime()
+    sage: a = int(1938) ^ int(99484)
+    sage: b = 1938 ^ 99484
+    sage: c = pari(1938) ^ pari(99484)
+    sage: cputime(t)
+    0.11
+
+.. [2] ``%macro``
+
+.. skip
+
+::
+
+    sage: E = EllipticCurve([1,2,3,4,5])
+    sage: M = ModularSymbols(37)
+    sage: %hist
+    E = EllipticCurve([1,2,3,4,5])
+    M = ModularSymbols(37)
+    %hist
+    sage: %macro em 1-2
+    Macro `em` created. To execute, type its name (without quotes).
+    === Macro contents: ===
+    E = EllipticCurve([Integer(1),Integer(2),Integer(3),Integer(4),Integer(5)])
+    M = ModularSymbols(Integer(37))

src/doc/el/tutorial/introduction.rst

@@ -0,0 +1,126 @@
+********
+Εισαγωγή
+********
+
+Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Το Sage βασίζεται
+επί το πλείστον στην Python, αλλά δεν προαπαιτείται κάποια γνώση της Python για
+να το χρησιμοποιήσετε. Για παράδειγμα:
+
+::
+
+    sage: 2 + 2
+    4
+    sage: factor(-2007)
+    -1 * 3^2 * 223
+
+    sage: A = matrix(4, 4, range(16)); A
+    [ 0  1  2  3]
+    [ 4  5  6  7]
+    [ 8  9 10 11]
+    [12 13 14 15]
+
+    sage: factor(A.charpoly())
+    x^2 * (x^2 - 30*x - 80)
+
+    sage: m = matrix(ZZ, 2, range(4))
+    sage: m[0,0] = m[0,0] - 3
+    sage: m
+    [-3  1]
+    [ 2  3]
+
+    sage: E = EllipticCurve([1, 2, 3, 4, 5]);  # Ελλειπτική καμπύλη
+    sage: E
+    Elliptic Curve defined by y^2 + x*y + 3*y = x^3 + 2*x^2 + 4*x + 5
+    over Rational Field
+    sage: E.anlist(10)
+    [0, 1, 1, 0, -1, -3, 0, -1, -3, -3, -3]
+    sage: E.rank()
+    1
+
+    sage: k = 1/(sqrt(3)*I + 3/4 + sqrt(73)*5/9); k
+    36/(20*sqrt(73) + 36*I*sqrt(3) + 27)
+    sage: N(k)
+    0.165495678130644 - 0.0521492082074256*I
+    sage: N(k, 30)  # 30 "bits"
+    0.16549568 - 0.052149208*I
+    sage: latex(k)
+    \frac{36}{20 \, \sqrt{73} + 36 i \, \sqrt{3} + 27}
+
+.. _installation:
+
+Εγκατάσταση
+===========
+
+Δείτε τον `Οδηγό Εγκατάστασης του Sage <https://doc.sagemath.org/html/en/installation/index.html>`_
+(`αυτός ο σύνδεσμος <../../en/installation/index.html>`_ θα πρέπει να σας
+οδηγήσει σε ένα τοπικό αντίγραφο του οδηγού εγκατάστασης).
+
+Εάν δεν έχετε το Sage εγκατεστημένο στον υπολογιστή σας μπορείτε να το
+δοκιμάσετε στο https://sagecell.sagemath.org.
+
+Στο αρχείο λήψης του Sage "συμπεριλαμβάνονται μπαταρίες". Με άλλα λόγια, αν και
+το Sage χρησιμοποιεί Python, IPython, PARI, GAP, Singular, Maxima, NTL, GMP και
+ούτω καθεξής, δεν χρειάζεται να τα εγκαταστήσετε χωριστά καθώς περιλαμβάνονται
+στη διανομή Sage. Ωστόσο, για να χρησιμοποιήσετε ορισμένες δυνατότητες του
+Sage, π.χ. Macaulay ή KASH, πρέπει να έχετε ήδη εγκατεστημένα στον υπολογιστή
+σας τα σχετικά προγράμματα.
+
+
+Τρόποι χρήσης του Sage
+======================
+
+Μπορείτε να χρησιμοποιήσετε το Sage με διάφορους τρόπους.
+
+
+-  **Διαδραστικό κέλυφος:** δείτε :ref:`chapter-interactive_shell`,
+
+-  **Γραφικό περιβάλλον notebook:** τρέξτε ``sage -n jupyter``· δείτε το
+   `the Jupyter documentation on-line <https://jupyter-notebook.readthedocs.io/en/latest/notebook.html>`_,
+
+-  **Προγράμματα:** γράφοντας διερμηνευμένα και μεταγλωττισμένα προγράμματα, ή
+   γράφοντας σκριπτάκια σε Python που κάνουν χρήση της βιβλιοθήκης Sage.
+
+Μακροχρόνιοι στόχοι για το Sage
+===============================
+
+-  **Χρήσιμο:** Το κοινό στο οποίο απευθύνεται το Sage είναι οι μαθητές
+   μαθηματικών, οι καθηγητές, και οι ερευνητικοί μαθηματικοί. Στόχος είναι η
+   παροχή λογισμικού που μπορεί να χρησιμοποιηθεί για να εξερευνήσουν και να
+   πειραματιστούν με μαθηματικές κατασκευές στην άλγεβρα, γεωμετρία, θεωρία
+   αριθμών, στον απειροστικό λογισμό, στους αριθμητικούς υπολογισμούς κ.λπ. Το
+   Sage διευκολύνει τον διαδραστικό πειραματισμό με μαθηματικά αντικείμενα.
+
+-  **Αποδοτικό:** Το Sage χρησιμοποιεί βελτιστοποιημένα και ώριμα λογισμικά
+   όπως τα GMP, PARI, GAP, και NTL, και ως εκ τούτου είναι πολύ γρήγορο σε
+   συγκεκριμένες λειτουργίες.
+
+-  **Δωρεάν και ανοιχτού κώδικα:** Ο πηγαίος κώδικας πρέπει να είναι ελεύθερα
+   διαθέσιμος και αναγνώσιμος, ώστε οι χρήστες να μπορούν να καταλάβουν τι
+   πραγματικά κάνει το σύστημα και να το επεκτείνουν ευκολότερα. Έτσι όπως
+   οι μαθηματικοί κατανοούν βαθύτερα ένα θεώρημα με προσεκτική ανάγνωση, έτσι
+   κι όσοι κάνουν υπολογισμούς είναι σε θέση να κατανοήσουν βαθύτερα τις
+   υπολογιστικές διαδιακαασίες διαβάζοντας τον πηγαίο κώδικα. Εάν
+   χρησιμοποιείτε το Sage για κάποια δημοσίευσή σας, να είστε σίγουροι ότι οι
+   αναγνώστες σας θα έχουν πάντα δωρεάν πρόσβαση στο Sage και σε όλο τον πηγαίο
+   κώδικά του, και μπορείτε ακόμη και να αρχειοθετήσετε και να αναδιανείμετε
+   την έκδοση του Sage που χρησιμοποιήσατε.
+
+-  **Εύχτιστο:** Το Sage οφείλει να είναι εύκολο στο χτίσιμο από τον πηγαίο
+   κώδικα για Linux, OS X, και Windows. Αυτό παρέχει στους χρήστες ευελιξία
+   τροποποίησης του συστήματος.
+
+-  **Συνεργατικό:** Παροχή ισχυρών διεπαφών για τα περισσότερα άλλα συστήματα
+   υπολογιστικής άλγεβρας, συμπεριλαμβανομένων των PARI, GAP, Singular, Maxima,
+   KASH, Magma, Maple, και Mathematica. Το Sage επιχειρεί να ενοποιήσει και να
+   επεκτείνει το υπάρχον λογισμικό μαθηματικών.
+
+-  **Εκτενής οδηγός:** Σεμινάρια, οδηγός προγραμματισμού, εγχειρίδιο αναφορών,
+   και συμβουλές, με πολλά παραδείγματα και συζήτηση του μαθηματικού υποβάθρου.
+
+-  **Επεκτάσιμο:** Να είναι σε θέση να ορίζει νέους τύπους δεδομένων ή να
+   συνάγει από ενσωματωμένους τύπους, και να κάνει χρήση κώδικα γραμμένου σε
+   διάφορες γλώσσες.
+
+-  **Εύχρηστο**: Ευκολία κατανόησης της παρεχόμενης λειτουργικότητας για κάθε
+   κατασκευή και της προβολής του εγχειριδίου και του πηγαίου κώδικα. Υψηλό
+   επίπεδο υποστήριξης του χρήστη.

src/doc/en/website/root_index.html

@@ -66,6 +66,7 @@ <h1>Sage Documentation</h1>
 <div class="cell lang">Greek</div>
 <div class="cell doc">
 <div class='entry lang-el'><a href='html/el/a_tour_of_sage/index.html'>A Tour of Sage</a></div>
+<div class='entry lang-el'><a href='html/el/tutorial/index.html'>Tutorial</a></div>
 </div></div>
 <div class="row hu"><div class="cell"></div>
 <div class="cell lang">Hungarian</div>