From 1b3bdf99bd502118d1accdc35bcd04c4fc7a8fe9 Mon Sep 17 00:00:00 2001 From: Giorgos Mousa Date: Thu, 1 Feb 2024 17:15:26 +0200 Subject: [PATCH 1/5] Translate introduction.rst --- src/doc/el/tutorial/introduction.rst | 157 +++++++++++++++++++++++++++ src/doc/en/website/root_index.html | 11 ++ 2 files changed, 168 insertions(+) create mode 100644 src/doc/el/tutorial/introduction.rst diff --git a/src/doc/el/tutorial/introduction.rst b/src/doc/el/tutorial/introduction.rst new file mode 100644 index 00000000000..6db73665c86 --- /dev/null +++ b/src/doc/el/tutorial/introduction.rst @@ -0,0 +1,157 @@ +******** +Εισαγωγή +******** + +Αυτό το μάθημα προβλέπεται να λάβει λιγότερο από 4 ώρες για την πλήρη +προσπέλασή του. Διατίθεται σε μορφή HTML και PDF, αλλά και από το +σημειωματάριο Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ στο +``Tutorial``, για μία διαδραστατική επαφή με το μάθημα μέσω του Sage. + +Παρότι το Sage βασίζεται επί το πλείστον στην Python, δεν προαπαιτείται κάποια +γνώση της Python για να παρακολουθήσετε αυτό το μάθημα. Εάν θελήσετε να μάθετε +Python στην πορεία, υπάρχουν πολλές εξαιρετικές και δωρεάν πηγές για αυτό: +[PyB]_. Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Για +παράδειγμα: + +:: + + 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 εγκατεστημένο στον υπολογιστή σας μπορείτε να το +δοκιμάσετε στο http://sagecell.sagemath.org. + +Ανατρέξτε στον Οδηγό Εγκατάστασης του Sage στην ενότητα του εγχειριδίου της +κύριας ιστοσελίδας του Sage [SA]_, για οδηγίες σχετικά με την εγκατάσταση του +Sage στον δικό σας υπολογιστή. Εδώ κάνουμε μόνο μερικά σχόλια. + + +#. Στο αρχείο λήψης του Sage "συμπεριλαμβάνονται μπαταρίες". Με άλλα λόγια, αν + και το Sage χρησιμοποιεί Python, IPython, PARI, GAP, Singular, Maxima, NTL, + GMP και ούτω καθεξής, δεν χρειάζεται να τα εγκαταστήσετε χωριστά καθώς + περιλαμβάνονται στη διανομή Sage. Ωστόσο, για να χρησιμοποιήσετε ορισμένες + δυνατότητες του Sage, π.χ. Macaulay ή KASH, πρέπει να έχετε ήδη + εγκατεστημένα στον υπολογιστή σας τα σχετικά προγράμματα. + +#. Το έτοιμο εκτελέσιμο του Sage (που βρίσκεται στην ιστοσελίδα του Sage) + είναι πιθανώς ταχύτερο κι ευκολότερο στην εγκατάσταση συγκριτικά με τον + πηγαίο κώδικα. Αρκεί να αποσυμπιέσετε το αρχείο και να τρέξετε την εντολή + ``sage``. + +#. Εάν θέλετε να χρησιμοποιήσετε το πακέτο SageTeX (το οποίο σας επιτρέπει να + ενσωματώσετε τα αποτελέσματα των υπολογισμών του Sage σε ένα αρχείο LaTeX), + θα χρειαστεί να κάνετε το SageTeX γνωστό στη διανομή TeX σας. Για να το + κάνετε αυτό, δείτε την ενότητα "Make SageTeX known to TeX" στον `Οδηγό + Εγκατάστασης του Sage `_ (`αυτός ο + σύνδεσμος <../../en/installation/index.html>`_ θα πρέπει να σας οδηγήσει σε + ένα τοπικό αντίγραφο του οδηγού εγκατάστασης). Είναι αρκετά εύκολο· απλά + πρέπει να ορίσετε μία μεταβλητή περιβάλλοντος ή να αντιγράψετε ένα + μεμονωμένο αρχείο σε έναν φάκελο που θα ψάξει το TeX. + + Το εγχειρίδιο χρήσης του SageTeX βρίσκεται στο + ``$SAGE_ROOT/venv/share/texmf/tex/latex/sagetex/``, όπου το "``$SAGE_ROOT``" + αναφέρεται στον κατάλογο όπου εγκαταστήσατε το Sage -- για παράδειγμα, + ``/opt/sage-10.3``. + +Τρόποι χρήσης του Sage +====================== + +Μπορείτε να χρησιμοποιήσετε το Sage με διάφορους τρόπους. + + +- **Γραφικό περιβάλλον notebook:** τρέξτε ``sage -n jupyter``; δείτε το + `the Jupyter documentation on-line `_, + +- **Διαδραστική γραμμή εντολών:** δείτε το :ref:`chapter-interactive_shell`, + +- **Προγράμματα:** γράφοντας διερμηνευμένα και μεταγλωττισμένα προγράμματα στο + Sage (δείτε το :ref:`section-loadattach` και το :ref:`section-compile`), και + +- **Σκριπτάκια:** γράφοντας σκριπτάκια σε Python που κάνουν χρήση της + βιβλιοθήκης Sage (δείτε το :ref:`section-standalone`). + + +Μακροχρόνιοι στόχοι για το 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 επιχειρεί να ενοποιήσει και να + επεκτείνει το υπάρχον λογισμικό μαθηματικών. + +- **Εκτενής οδηγός:** Μαθήματα, οδηγός προγραμματισμού, εγχειρίδιο αναφορών, + και συμβουλές, με πολλά παραδείγματα και συζήτηση του μαθηματικού υποβάθρου. + +- **Επεκτάσιμο:** Να είναι σε θέση να ορίζει νέους τύπους δεδομένων ή να + συνάγει από ενσωματωμένους τύπους, και να κάνει χρήση κώδικα γραμμένου σε + διάφορες γλώσσες. + +- **Εύχρηστο**: Ευκολία κατανόησης της παρεχόμενης λειτουργικότητας για κάθε + κατασκευή και της προβολής του εγχειριδίου και του πηγαίου κώδικα. Υψηλό + επίπεδο υποστήριξης του χρήστη. diff --git a/src/doc/en/website/root_index.html b/src/doc/en/website/root_index.html index c3d25ff495b..5e4e8842c4f 100644 --- a/src/doc/en/website/root_index.html +++ b/src/doc/en/website/root_index.html @@ -62,6 +62,12 @@

Sage Documentation

Tutorial
Thematic Tutorials
+
+
Greek
+
+
A Tour of Sage
+
Tutorial
+
Hungarian
@@ -135,6 +141,11 @@

Sage Documentation

Tutorial
Thematic Tutorials
+
+
Greek
+
+
A Tour of Sage
+
Hungarian
From b2dd1f3811c13d31d437f3090824a2f31a13b75f Mon Sep 17 00:00:00 2001 From: Giorgos Mousa Date: Thu, 1 Feb 2024 21:35:02 +0200 Subject: [PATCH 2/5] Translate tour.rst --- src/doc/el/tutorial/tour.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 src/doc/el/tutorial/tour.rst diff --git a/src/doc/el/tutorial/tour.rst b/src/doc/el/tutorial/tour.rst new file mode 100644 index 00000000000..af0131ae685 --- /dev/null +++ b/src/doc/el/tutorial/tour.rst @@ -0,0 +1,30 @@ +******** +Ξενάγηση +******** + +Αυτή η ενότητα είναι μια ξενάγηση του τι διατίθεται στο Sage. Για πολλά ακόμη +παραδείγματα, δείτε το "Sage Constructions", το οποίο προορίζεται να απαντήσει +στη γενική ερώτηση «Πώς κατασκευάζω...;». Δείτε επίσης το "Sage Reference +Manual", το οποίο έχει χιλιάδες ακόμη παραδείγματα. Σημειώστε επίσης ότι +μπορείτε να εργαστείτε διαδραστικά μέσω αυτής της περιήγησης στο Σημειωματάριο +Sage κάνοντας κλικ στον σύνδεσμο ``Help``. + +(Εάν βλέπετε το σεμινάριο στο Σημειωματάριο Sage, πατήστε ``shift-enter`` για +τον υπολογισμό οποιουδήποτε κελιού εισόδου. Μπορείτε ακόμη και να +επεξεργαστείτε την είσοδο πριν πατήσετε το shift-enter. Σε κάποια Mac ίσως +χρειαστεί να πατήσετε ``shift-return`` αντί για ``shift-enter``.) + +.. toctree:: + + tour_assignment + tour_help + tour_algebra + tour_plotting + tour_functions + tour_rings + tour_linalg + tour_polynomial + tour_coercion + tour_groups + tour_numtheory + tour_advanced From 1c8cb40ca4ece54a272a00f783a10e3effdf3aa1 Mon Sep 17 00:00:00 2001 From: Giorgos Mousa Date: Thu, 1 Feb 2024 21:49:14 +0200 Subject: [PATCH 3/5] Translate appendix.rst and bibliography.rst --- src/doc/el/tutorial/appendix.rst | 30 +++++++++++++++++ src/doc/el/tutorial/bibliography.rst | 50 ++++++++++++++++++++++++++++ 2 files changed, 80 insertions(+) create mode 100644 src/doc/el/tutorial/appendix.rst create mode 100644 src/doc/el/tutorial/bibliography.rst diff --git a/src/doc/el/tutorial/appendix.rst b/src/doc/el/tutorial/appendix.rst new file mode 100644 index 00000000000..a66e477f9b2 --- /dev/null +++ b/src/doc/el/tutorial/appendix.rst @@ -0,0 +1,30 @@ +******** +Παράθεμα +******** + +.. _section-precedence: + +Προτεραιότητα αριθμητικών τελεστών με δύο ορίσματα +================================================== + +Ποιά είναι η τιμή του ``3^2*4 + 2%5``; Η τιμή (38) καθορίζεται από τον ακόλουθο +πίνακα προτεραιτήτων. Ο παρακάτω πίνακας βασίζεται στον πίνακα στο § 5.14 του +*Python Language Reference Manual* από τους G. Rossum και F. Drake. Οι τελεστές +παραθέτονται εδώ σε αύξουσα σειρά προτεραιότητας. + +========================== ================= +Τελεστής Περιγραφή +========================== ================= +or boolean or +and boolean and +not boolean not +in, not in membership +is, is not identity test +>, <=, >, >=, ==, != comparison ++, - addition, subtraction +\*, /, % multiplication, division, remainder +\*\*, ^ exponentiation +========================== ================= + +Επομένως, για τον υπολογισμό του ``3^2*4 + 2%5``, το Sage κάνει τον εξής +υπολογισμό: ``((3^2)*4) + (2%5)``. diff --git a/src/doc/el/tutorial/bibliography.rst b/src/doc/el/tutorial/bibliography.rst new file mode 100644 index 00000000000..db7b8af2c98 --- /dev/null +++ b/src/doc/el/tutorial/bibliography.rst @@ -0,0 +1,50 @@ +************ +Βιβλιογραφία +************ + +.. [Cyt] Cython, http://www.cython.org + +.. [GAP] The GAP Group, GAP - Groups, Algorithms, and + Programming, Version 4.4; 2005, https://www.gap-system.org + +.. [GAPkg] GAP Packages, + https://www.gap-system.org/Packages/packages.html + +.. [GP] PARI/GP, https://pari.math.u-bordeaux.fr/ + +.. [Mag] Magma, http://magma.maths.usyd.edu.au/magma/ + +.. [Max] Maxima, http://maxima.sf.net/ + +.. [NagleEtAl2004] Nagle, Saff, and Snider. + *Fundamentals of Differential Equations*. 6th edition, Addison-Wesley, + 2004. + +.. [Py] The Python language, http://www.python.org/ + +.. [PyB] The Python Beginner's Guide, + https://wiki.python.org/moin/BeginnersGuide + +.. [PyDev] Python Developer's Guide, + https://docs.python.org/devguide/ + +.. [PyLR] Python Library Reference, + https://docs.python.org/3/library/index.html + +.. [Pyr] Pyrex, + http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/ + +.. [PyT] The Python Tutorial, + https://docs.python.org/3/tutorial/ + +.. [SA] Sage web site, https://www.sagemath.org/ + +.. [Si] \G.-M. Greuel, G. Pfister, and H. Schönemann. Singular + 3.0. A Computer Algebra System for Polynomial Computations. Center + for Computer Algebra, University of Kaiserslautern (2005). + https://www.singular.uni-kl.de + +.. [SJ] William Stein, David Joyner, Sage: System for Algebra and + Geometry Experimentation, Comm. Computer Algebra {39} (2005) 61-64. + +.. [ThreeJS] three.js, http://threejs.org From 325f27d97debc91bc7b8f66c33ece6d354d52beb Mon Sep 17 00:00:00 2001 From: Giorgos Mousa Date: Thu, 1 Feb 2024 22:20:10 +0200 Subject: [PATCH 4/5] Translate index.rst --- src/doc/el/tutorial/index.rst | 49 ++++++++++++++++++++++++++++ src/doc/el/tutorial/introduction.rst | 14 ++++---- 2 files changed, 56 insertions(+), 7 deletions(-) create mode 100644 src/doc/el/tutorial/index.rst diff --git a/src/doc/el/tutorial/index.rst b/src/doc/el/tutorial/index.rst new file mode 100644 index 00000000000..cb560f07669 --- /dev/null +++ b/src/doc/el/tutorial/index.rst @@ -0,0 +1,49 @@ +.. 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 + tour + interactive_shell + interfaces + latex + programming + sagetex + afterword + appendix + bibliography + +Ευρετήριο και πίνακες +===================== + +* :ref:`genindex` +* :ref:`search` diff --git a/src/doc/el/tutorial/introduction.rst b/src/doc/el/tutorial/introduction.rst index 6db73665c86..e117ca1e67e 100644 --- a/src/doc/el/tutorial/introduction.rst +++ b/src/doc/el/tutorial/introduction.rst @@ -2,15 +2,15 @@ Εισαγωγή ******** -Αυτό το μάθημα προβλέπεται να λάβει λιγότερο από 4 ώρες για την πλήρη -προσπέλασή του. Διατίθεται σε μορφή HTML και PDF, αλλά και από το -σημειωματάριο Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ στο -``Tutorial``, για μία διαδραστατική επαφή με το μάθημα μέσω του Sage. +Αυτό το σεμινάριο είναι ο καλύτερος τρόπος για να εξοικειωθείτε με το Sage σε +λίγες ώρες. Διατίθεται σε μορφή HTML και PDF, αλλά και από το σημειωματάριο +Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ στο ``Tutorial``, για μία +διαδραστική επαφή με το σεμινάριο μέσω του Sage. Παρότι το Sage βασίζεται επί το πλείστον στην Python, δεν προαπαιτείται κάποια -γνώση της Python για να παρακολουθήσετε αυτό το μάθημα. Εάν θελήσετε να μάθετε -Python στην πορεία, υπάρχουν πολλές εξαιρετικές και δωρεάν πηγές για αυτό: -[PyB]_. Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Για +γνώση της Python για να παρακολουθήσετε αυτό το σεμινάριο. Εάν θελήσετε να +μάθετε Python στην πορεία, υπάρχουν πολλές εξαιρετικές και δωρεάν πηγές για +αυτό: [PyB]_. Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Για παράδειγμα: :: From 1317773729b1f0f2ab8b57e7c02759ac8d777f7c Mon Sep 17 00:00:00 2001 From: Giorgos Mousa Date: Wed, 29 May 2024 16:59:06 +0000 Subject: [PATCH 5/5] Add Greek tutorial A simple first version translated and edited from the English version. Articles worth including in the future: `programming`. --- src/doc/el/tutorial/appendix.rst | 30 ------- src/doc/el/tutorial/bibliography.rst | 50 ----------- src/doc/el/tutorial/conf.py | 43 +++++++++ src/doc/el/tutorial/index.rst | 16 +--- src/doc/el/tutorial/interactive_shell.rst | 101 ++++++++++++++++++++++ src/doc/el/tutorial/introduction.rst | 77 +++++------------ src/doc/el/tutorial/tour.rst | 30 ------- 7 files changed, 168 insertions(+), 179 deletions(-) delete mode 100644 src/doc/el/tutorial/appendix.rst delete mode 100644 src/doc/el/tutorial/bibliography.rst create mode 100644 src/doc/el/tutorial/conf.py create mode 100644 src/doc/el/tutorial/interactive_shell.rst delete mode 100644 src/doc/el/tutorial/tour.rst diff --git a/src/doc/el/tutorial/appendix.rst b/src/doc/el/tutorial/appendix.rst deleted file mode 100644 index a66e477f9b2..00000000000 --- a/src/doc/el/tutorial/appendix.rst +++ /dev/null @@ -1,30 +0,0 @@ -******** -Παράθεμα -******** - -.. _section-precedence: - -Προτεραιότητα αριθμητικών τελεστών με δύο ορίσματα -================================================== - -Ποιά είναι η τιμή του ``3^2*4 + 2%5``; Η τιμή (38) καθορίζεται από τον ακόλουθο -πίνακα προτεραιτήτων. Ο παρακάτω πίνακας βασίζεται στον πίνακα στο § 5.14 του -*Python Language Reference Manual* από τους G. Rossum και F. Drake. Οι τελεστές -παραθέτονται εδώ σε αύξουσα σειρά προτεραιότητας. - -========================== ================= -Τελεστής Περιγραφή -========================== ================= -or boolean or -and boolean and -not boolean not -in, not in membership -is, is not identity test ->, <=, >, >=, ==, != comparison -+, - addition, subtraction -\*, /, % multiplication, division, remainder -\*\*, ^ exponentiation -========================== ================= - -Επομένως, για τον υπολογισμό του ``3^2*4 + 2%5``, το Sage κάνει τον εξής -υπολογισμό: ``((3^2)*4) + (2%5)``. diff --git a/src/doc/el/tutorial/bibliography.rst b/src/doc/el/tutorial/bibliography.rst deleted file mode 100644 index db7b8af2c98..00000000000 --- a/src/doc/el/tutorial/bibliography.rst +++ /dev/null @@ -1,50 +0,0 @@ -************ -Βιβλιογραφία -************ - -.. [Cyt] Cython, http://www.cython.org - -.. [GAP] The GAP Group, GAP - Groups, Algorithms, and - Programming, Version 4.4; 2005, https://www.gap-system.org - -.. [GAPkg] GAP Packages, - https://www.gap-system.org/Packages/packages.html - -.. [GP] PARI/GP, https://pari.math.u-bordeaux.fr/ - -.. [Mag] Magma, http://magma.maths.usyd.edu.au/magma/ - -.. [Max] Maxima, http://maxima.sf.net/ - -.. [NagleEtAl2004] Nagle, Saff, and Snider. - *Fundamentals of Differential Equations*. 6th edition, Addison-Wesley, - 2004. - -.. [Py] The Python language, http://www.python.org/ - -.. [PyB] The Python Beginner's Guide, - https://wiki.python.org/moin/BeginnersGuide - -.. [PyDev] Python Developer's Guide, - https://docs.python.org/devguide/ - -.. [PyLR] Python Library Reference, - https://docs.python.org/3/library/index.html - -.. [Pyr] Pyrex, - http://www.cosc.canterbury.ac.nz/~greg/python/Pyrex/ - -.. [PyT] The Python Tutorial, - https://docs.python.org/3/tutorial/ - -.. [SA] Sage web site, https://www.sagemath.org/ - -.. [Si] \G.-M. Greuel, G. Pfister, and H. Schönemann. Singular - 3.0. A Computer Algebra System for Polynomial Computations. Center - for Computer Algebra, University of Kaiserslautern (2005). - https://www.singular.uni-kl.de - -.. [SJ] William Stein, David Joyner, Sage: System for Algebra and - Geometry Experimentation, Comm. Computer Algebra {39} (2005) 61-64. - -.. [ThreeJS] three.js, http://threejs.org diff --git a/src/doc/el/tutorial/conf.py b/src/doc/el/tutorial/conf.py new file mode 100644 index 00000000000..7b475a3bb6e --- /dev/null +++ b/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'), +] diff --git a/src/doc/el/tutorial/index.rst b/src/doc/el/tutorial/index.rst index cb560f07669..5e303ffdc4f 100644 --- a/src/doc/el/tutorial/index.rst +++ b/src/doc/el/tutorial/index.rst @@ -18,7 +18,7 @@ των Maple, Mathematica, Magma, και MATLAB. Αυτό το σεμινάριο είναι ο καλύτερος τρόπος για να εξοικειωθείτε με το Sage -σε λίγες ώρες. Μπορείτε να το διαβάσετε σε εκδόσεις HTML ή PDF ή από το +σε λίγη ώρα. Μπορείτε να το διαβάσετε σε εκδόσεις HTML ή PDF ή από το σημειωματάριο Sage (κάντε κλικ στην επιλογή ``Help`` και, στη συνέχεια, κάντε κλικ στην επιλογή ``Tutorial`` για να διαδράσετε με το σεμινάριο μέσα από το Sage). @@ -32,18 +32,4 @@ __ http://creativecommons.org/licenses/by-sa/3.0/ :maxdepth: 2 introduction - tour interactive_shell - interfaces - latex - programming - sagetex - afterword - appendix - bibliography - -Ευρετήριο και πίνακες -===================== - -* :ref:`genindex` -* :ref:`search` diff --git a/src/doc/el/tutorial/interactive_shell.rst b/src/doc/el/tutorial/interactive_shell.rst new file mode 100644 index 00000000000..79bdb1e8992 --- /dev/null +++ b/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)) diff --git a/src/doc/el/tutorial/introduction.rst b/src/doc/el/tutorial/introduction.rst index e117ca1e67e..f87d03b6ec6 100644 --- a/src/doc/el/tutorial/introduction.rst +++ b/src/doc/el/tutorial/introduction.rst @@ -2,16 +2,9 @@ Εισαγωγή ******** -Αυτό το σεμινάριο είναι ο καλύτερος τρόπος για να εξοικειωθείτε με το Sage σε -λίγες ώρες. Διατίθεται σε μορφή HTML και PDF, αλλά και από το σημειωματάριο -Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ στο ``Tutorial``, για μία -διαδραστική επαφή με το σεμινάριο μέσω του Sage. - -Παρότι το Sage βασίζεται επί το πλείστον στην Python, δεν προαπαιτείται κάποια -γνώση της Python για να παρακολουθήσετε αυτό το σεμινάριο. Εάν θελήσετε να -μάθετε Python στην πορεία, υπάρχουν πολλές εξαιρετικές και δωρεάν πηγές για -αυτό: [PyB]_. Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Για -παράδειγμα: +Αν θέλετε μία πρώτη άποψη του Sage, είστε στο σωστό μέρος. Το Sage βασίζεται +επί το πλείστον στην Python, αλλά δεν προαπαιτείται κάποια γνώση της Python για +να το χρησιμοποιήσετε. Για παράδειγμα: :: @@ -48,7 +41,7 @@ Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ 36/(20*sqrt(73) + 36*I*sqrt(3) + 27) sage: N(k) 0.165495678130644 - 0.0521492082074256*I - sage: N(k,30) # 30 "bits" + sage: N(k, 30) # 30 "bits" 0.16549568 - 0.052149208*I sage: latex(k) \frac{36}{20 \, \sqrt{73} + 36 i \, \sqrt{3} + 27} @@ -58,40 +51,20 @@ Sage, πληκτρολογώντας ``Help`` και κάνοντας κλικ Εγκατάσταση =========== +Δείτε τον `Οδηγό Εγκατάστασης του Sage `_ +(`αυτός ο σύνδεσμος <../../en/installation/index.html>`_ θα πρέπει να σας +οδηγήσει σε ένα τοπικό αντίγραφο του οδηγού εγκατάστασης). + Εάν δεν έχετε το Sage εγκατεστημένο στον υπολογιστή σας μπορείτε να το -δοκιμάσετε στο http://sagecell.sagemath.org. - -Ανατρέξτε στον Οδηγό Εγκατάστασης του Sage στην ενότητα του εγχειριδίου της -κύριας ιστοσελίδας του Sage [SA]_, για οδηγίες σχετικά με την εγκατάσταση του -Sage στον δικό σας υπολογιστή. Εδώ κάνουμε μόνο μερικά σχόλια. - - -#. Στο αρχείο λήψης του Sage "συμπεριλαμβάνονται μπαταρίες". Με άλλα λόγια, αν - και το Sage χρησιμοποιεί Python, IPython, PARI, GAP, Singular, Maxima, NTL, - GMP και ούτω καθεξής, δεν χρειάζεται να τα εγκαταστήσετε χωριστά καθώς - περιλαμβάνονται στη διανομή Sage. Ωστόσο, για να χρησιμοποιήσετε ορισμένες - δυνατότητες του Sage, π.χ. Macaulay ή KASH, πρέπει να έχετε ήδη - εγκατεστημένα στον υπολογιστή σας τα σχετικά προγράμματα. - -#. Το έτοιμο εκτελέσιμο του Sage (που βρίσκεται στην ιστοσελίδα του Sage) - είναι πιθανώς ταχύτερο κι ευκολότερο στην εγκατάσταση συγκριτικά με τον - πηγαίο κώδικα. Αρκεί να αποσυμπιέσετε το αρχείο και να τρέξετε την εντολή - ``sage``. - -#. Εάν θέλετε να χρησιμοποιήσετε το πακέτο SageTeX (το οποίο σας επιτρέπει να - ενσωματώσετε τα αποτελέσματα των υπολογισμών του Sage σε ένα αρχείο LaTeX), - θα χρειαστεί να κάνετε το SageTeX γνωστό στη διανομή TeX σας. Για να το - κάνετε αυτό, δείτε την ενότητα "Make SageTeX known to TeX" στον `Οδηγό - Εγκατάστασης του Sage `_ (`αυτός ο - σύνδεσμος <../../en/installation/index.html>`_ θα πρέπει να σας οδηγήσει σε - ένα τοπικό αντίγραφο του οδηγού εγκατάστασης). Είναι αρκετά εύκολο· απλά - πρέπει να ορίσετε μία μεταβλητή περιβάλλοντος ή να αντιγράψετε ένα - μεμονωμένο αρχείο σε έναν φάκελο που θα ψάξει το TeX. - - Το εγχειρίδιο χρήσης του SageTeX βρίσκεται στο - ``$SAGE_ROOT/venv/share/texmf/tex/latex/sagetex/``, όπου το "``$SAGE_ROOT``" - αναφέρεται στον κατάλογο όπου εγκαταστήσατε το Sage -- για παράδειγμα, - ``/opt/sage-10.3``. +δοκιμάσετε στο https://sagecell.sagemath.org. + +Στο αρχείο λήψης του Sage "συμπεριλαμβάνονται μπαταρίες". Με άλλα λόγια, αν και +το Sage χρησιμοποιεί Python, IPython, PARI, GAP, Singular, Maxima, NTL, GMP και +ούτω καθεξής, δεν χρειάζεται να τα εγκαταστήσετε χωριστά καθώς περιλαμβάνονται +στη διανομή Sage. Ωστόσο, για να χρησιμοποιήσετε ορισμένες δυνατότητες του +Sage, π.χ. Macaulay ή KASH, πρέπει να έχετε ήδη εγκατεστημένα στον υπολογιστή +σας τα σχετικά προγράμματα. + Τρόποι χρήσης του Sage ====================== @@ -99,17 +72,13 @@ Sage στον δικό σας υπολογιστή. Εδώ κάνουμε μόν Μπορείτε να χρησιμοποιήσετε το Sage με διάφορους τρόπους. -- **Γραφικό περιβάλλον notebook:** τρέξτε ``sage -n jupyter``; δείτε το - `the Jupyter documentation on-line `_, - -- **Διαδραστική γραμμή εντολών:** δείτε το :ref:`chapter-interactive_shell`, +- **Διαδραστικό κέλυφος:** δείτε :ref:`chapter-interactive_shell`, -- **Προγράμματα:** γράφοντας διερμηνευμένα και μεταγλωττισμένα προγράμματα στο - Sage (δείτε το :ref:`section-loadattach` και το :ref:`section-compile`), και - -- **Σκριπτάκια:** γράφοντας σκριπτάκια σε Python που κάνουν χρήση της - βιβλιοθήκης Sage (δείτε το :ref:`section-standalone`). +- **Γραφικό περιβάλλον notebook:** τρέξτε ``sage -n jupyter``· δείτε το + `the Jupyter documentation on-line `_, +- **Προγράμματα:** γράφοντας διερμηνευμένα και μεταγλωττισμένα προγράμματα, ή + γράφοντας σκριπτάκια σε Python που κάνουν χρήση της βιβλιοθήκης Sage. Μακροχρόνιοι στόχοι για το Sage =============================== @@ -145,7 +114,7 @@ Sage στον δικό σας υπολογιστή. Εδώ κάνουμε μόν KASH, Magma, Maple, και Mathematica. Το Sage επιχειρεί να ενοποιήσει και να επεκτείνει το υπάρχον λογισμικό μαθηματικών. -- **Εκτενής οδηγός:** Μαθήματα, οδηγός προγραμματισμού, εγχειρίδιο αναφορών, +- **Εκτενής οδηγός:** Σεμινάρια, οδηγός προγραμματισμού, εγχειρίδιο αναφορών, και συμβουλές, με πολλά παραδείγματα και συζήτηση του μαθηματικού υποβάθρου. - **Επεκτάσιμο:** Να είναι σε θέση να ορίζει νέους τύπους δεδομένων ή να diff --git a/src/doc/el/tutorial/tour.rst b/src/doc/el/tutorial/tour.rst deleted file mode 100644 index af0131ae685..00000000000 --- a/src/doc/el/tutorial/tour.rst +++ /dev/null @@ -1,30 +0,0 @@ -******** -Ξενάγηση -******** - -Αυτή η ενότητα είναι μια ξενάγηση του τι διατίθεται στο Sage. Για πολλά ακόμη -παραδείγματα, δείτε το "Sage Constructions", το οποίο προορίζεται να απαντήσει -στη γενική ερώτηση «Πώς κατασκευάζω...;». Δείτε επίσης το "Sage Reference -Manual", το οποίο έχει χιλιάδες ακόμη παραδείγματα. Σημειώστε επίσης ότι -μπορείτε να εργαστείτε διαδραστικά μέσω αυτής της περιήγησης στο Σημειωματάριο -Sage κάνοντας κλικ στον σύνδεσμο ``Help``. - -(Εάν βλέπετε το σεμινάριο στο Σημειωματάριο Sage, πατήστε ``shift-enter`` για -τον υπολογισμό οποιουδήποτε κελιού εισόδου. Μπορείτε ακόμη και να -επεξεργαστείτε την είσοδο πριν πατήσετε το shift-enter. Σε κάποια Mac ίσως -χρειαστεί να πατήσετε ``shift-return`` αντί για ``shift-enter``.) - -.. toctree:: - - tour_assignment - tour_help - tour_algebra - tour_plotting - tour_functions - tour_rings - tour_linalg - tour_polynomial - tour_coercion - tour_groups - tour_numtheory - tour_advanced