Nette Documentation Preview

syntax
Πώς να ανοίξετε ένα αρχείο στον Editor από το Tracy; (Ενσωμάτωση IDE)
*********************************************************************

.[perex]
Όταν εμφανίζεται η σελίδα σφάλματος, μπορείτε να κάνετε κλικ στα ονόματα των αρχείων και αυτά θα ανοίξουν στον επεξεργαστή σας με τον κέρσορα στην αντίστοιχη γραμμή. Μπορείτε επίσης να δημιουργήσετε αρχεία (ενέργεια `create file`) ή να διορθώσετε σφάλματα σε αυτά (ενέργεια `fix it`). Για να το κάνετε αυτό, πρέπει να ρυθμίσετε το πρόγραμμα περιήγησης και το σύστημα.

Το Tracy ανοίγει αρχεία μέσω διευθύνσεων URL της μορφής `editor://open/?file=%file&line=%line`, δηλαδή με το πρωτόκολλο `editor://`. Θα καταχωρήσουμε τον δικό μας χειριστή για αυτό. Αυτός μπορεί να είναι οποιοδήποτε εκτελέσιμο αρχείο που επεξεργάζεται τις παραμέτρους και ξεκινά τον αγαπημένο μας επεξεργαστή.

Μπορείτε να αλλάξετε τη διεύθυνση URL στη μεταβλητή `Tracy\Debugger::$editor` ή να απενεργοποιήσετε το click-through θέτοντας το `Tracy\Debugger::$editor = null`.


Windows .[#toc-windows]
=======================

1. Κατεβάστε τα κατάλληλα αρχεία "από το αποθετήριο Tracy":https://github.com/nette/tracy/tree/master/tools/open-in-editor/windows στο δίσκο.

2. Επεξεργαστείτε το `open-editor.js` και ξεσχολιάστε ή επεξεργαστείτε τη διαδρομή προς τον επεξεργαστή σας στο `settings`:

```js
var settings = {

	// PhpStorm
	editor: '"C:\\Program Files\\JetBrains\\PhpStorm 2018.1.2\\bin\\phpstorm64.exe" --line %line% "%file%"',
	title: 'PhpStorm',

	// NetBeans
	// editor: '"C:\\Program Files\\NetBeans 8.1\\bin\\netbeans.exe" "%file%:%line%" --console suppress',

	// Sublime Text 2
	// editor: '"C:\\Program Files\\Sublime Text 2\\sublime_text.exe" "%file%:%line%"',

	...
}

...
```

Να είστε προσεκτικοί και να διατηρήσετε τις διπλές κάθετους στις διαδρομές.

3. Καταχωρήστε τον χειριστή για το πρωτόκολλο `editor://` στο σύστημα.

Αυτό γίνεται εκτελώντας το `install.cmd`. **Πρέπει να το εκτελέσετε ως διαχειριστής.** Το σενάριο `open-editor.js` θα εξυπηρετεί τώρα το πρωτόκολλο `editor://`.

Για να ανοίξετε συνδέσμους που δημιουργούνται σε άλλους διακομιστές, όπως ένας διακομιστής παραγωγής ή ο Docker, προσθέστε μια αντιστοίχιση απομακρυσμένης σε τοπική διεύθυνση URL στο `open-editor.js`:

```js
	mappings: {
		// remote path: local path
		'/var/www/nette.app': 'W:\\Nette.web\\_web',
	}
```


Linux .[#toc-linux]
===================

1. Κατεβάστε τα κατάλληλα αρχεία "από το αποθετήριο Tracy":https://github.com/nette/tracy/tree/master/tools/open-in-editor/linux στον κατάλογο `~/bin`.

2. Επεξεργαστείτε το `open-editor.sh` και ξεσχολιάστε ή επεξεργαστείτε τη διαδρομή προς τον επεξεργαστή σας στη μεταβλητή `editor`:

```shell
#!/bin/bash

# Emacs
#editor='emacs +$LINE "$FILE"'

# gVim
#editor='gvim +$LINE "$FILE"'

# gEdit
#editor='gedit +$LINE "$FILE"'

# Pluma
#editor='pluma +$LINE "$FILE"'

...
```

Κάντε το εκτελέσιμο:

```shell
chmod +x ~/bin/open-editor.sh
```

Αν ο επεξεργαστής που χρησιμοποιείτε δεν έχει εγκατασταθεί από το πακέτο, το δυαδικό αρχείο πιθανόν να μην έχει διαδρομή στο `$PATH`. Αυτό μπορεί να διορθωθεί εύκολα. Στον κατάλογο `~/bin`, δημιουργήστε έναν συμβολικό σύνδεσμο στο δυαδικό αρχείο του επεξεργαστή. .[note]


3. Καταχωρήστε τον χειριστή για το πρωτόκολλο `editor://` στο σύστημα.

Αυτό γίνεται με την εκτέλεση του `install.sh`. Το σενάριο `open-editor.js` θα εξυπηρετεί τώρα το πρωτόκολλο `editor://`.


macOS .[#toc-macos]
===================

Επεξεργαστές όπως το PhpStorm, το TextMate κ.λπ. σας επιτρέπουν να ανοίγετε αρχεία μέσω μιας ειδικής διεύθυνσης URL, την οποία απλώς πρέπει να ορίσετε:

```php
// PhpStorm
Tracy\Debugger::$editor = 'phpstorm://open?file=%file&line=%line';
// TextMate
Tracy\Debugger::$editor = 'txmt://open/?url=file://%file&line=%line';
// MacVim
Tracy\Debugger::$editor = 'mvim://open/?url=file://%file&line=%line';
// Visual Studio Code
Tracy\Debugger::$editor = 'vscode://file/%file:%line';
```

Αν χρησιμοποιείτε το standalone Tracy, βάλτε τη γραμμή πριν από το `Tracy\Debugger::enable()`, αν το Nette, πριν από το `$configurator->enableTracy()` στο `Bootstrap.php`.

Δυστυχώς, οι ενέργειες `create file` ή `fix it` δεν λειτουργούν στο macOS.


Επιδείξεις .[#toc-demos]
========================

Διόρθωση σφάλματος:

<iframe width="560" height="315" src="<m id=49/> frameborder="0" allow="encrypted-media" allowfullscreen></iframe>

Δημιουργία νέου αρχείου:

<iframe width="560" height="315" src="https://www.youtube.com/embed/AJ_FUivAGZQ?rel=0&showinfo=0" frameborder="0" allow="encrypted-media" allowfullscreen></iframe>


Αντιμετώπιση προβλημάτων .[#toc-troubleshooting]
================================================

- Στον Firefox μπορεί να χρειαστεί να [επιτρέψετε την |http://kb.mozillazine.org/Register_protocol#Firefox_3.5_and_above] εκτέλεση προσαρμοσμένου πρωτοκόλλου στο about:config, ορίζοντας το `network.protocol-handler.expose.editor` σε `false` και το `network.protocol-handler.expose-all` σε `true`. Θα πρέπει να επιτρέπεται από προεπιλογή, ωστόσο.
- Αν δεν λειτουργούν όλα αμέσως, μην πανικοβάλλεστε. Προσπαθήστε να ανανεώσετε τη σελίδα, να κάνετε επανεκκίνηση του προγράμματος περιήγησης ή του υπολογιστή. Αυτό θα πρέπει να βοηθήσει.
- Δείτε [εδώ |https://www.winhelponline.com/blog/error-there-is-no-script-engine-for-file-extension-when-running-js-files/] για να το διορθώσετε:
 Σφάλμα εισόδου: Ίσως συσχετίσατε το αρχείο ".js" με μια άλλη εφαρμογή, όχι με τη μηχανή JScript.

Ξεκινώντας από την έκδοση 77 του Google Chrome, δεν θα βλέπετε πλέον το πλαίσιο ελέγχου "Να ανοίγετε πάντα αυτούς τους τύπους συνδέσμων στη συνδεδεμένη εφαρμογή" όταν ανοίγει ο επεξεργαστής μέσω ενός συνδέσμου. Αντιμετώπιση για τα Windows: δημιουργήστε το αρχείο `fix.reg`:

```
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\URLWhitelist]
"123"="editor://*"
```
Εισάγετε το με διπλό κλικ και επανεκκινήστε το Chrome.


Σε περίπτωση περισσότερων προβλημάτων ή ερωτήσεων, ρωτήστε στο [φόρουμ |https://forum.nette.org].

Πώς να ανοίξετε ένα αρχείο στον Editor από το Tracy; (Ενσωμάτωση IDE)

Όταν εμφανίζεται η σελίδα σφάλματος, μπορείτε να κάνετε κλικ στα ονόματα των αρχείων και αυτά θα ανοίξουν στον επεξεργαστή σας με τον κέρσορα στην αντίστοιχη γραμμή. Μπορείτε επίσης να δημιουργήσετε αρχεία (ενέργεια create file) ή να διορθώσετε σφάλματα σε αυτά (ενέργεια fix it). Για να το κάνετε αυτό, πρέπει να ρυθμίσετε το πρόγραμμα περιήγησης και το σύστημα.

Το Tracy ανοίγει αρχεία μέσω διευθύνσεων URL της μορφής editor://open/?file=%file&line=%line, δηλαδή με το πρωτόκολλο editor://. Θα καταχωρήσουμε τον δικό μας χειριστή για αυτό. Αυτός μπορεί να είναι οποιοδήποτε εκτελέσιμο αρχείο που επεξεργάζεται τις παραμέτρους και ξεκινά τον αγαπημένο μας επεξεργαστή.

Μπορείτε να αλλάξετε τη διεύθυνση URL στη μεταβλητή Tracy\Debugger::$editor ή να απενεργοποιήσετε το click-through θέτοντας το Tracy\Debugger::$editor = null.

Windows

  1. Κατεβάστε τα κατάλληλα αρχεία από το αποθετήριο Tracy στο δίσκο.
  2. Επεξεργαστείτε το open-editor.js και ξεσχολιάστε ή επεξεργαστείτε τη διαδρομή προς τον επεξεργαστή σας στο settings:
var settings = {

	// PhpStorm
	editor: '"C:\\Program Files\\JetBrains\\PhpStorm 2018.1.2\\bin\\phpstorm64.exe" --line %line% "%file%"',
	title: 'PhpStorm',

	// NetBeans
	// editor: '"C:\\Program Files\\NetBeans 8.1\\bin\\netbeans.exe" "%file%:%line%" --console suppress',

	// Sublime Text 2
	// editor: '"C:\\Program Files\\Sublime Text 2\\sublime_text.exe" "%file%:%line%"',

	...
}

...

Να είστε προσεκτικοί και να διατηρήσετε τις διπλές κάθετους στις διαδρομές.

3. Καταχωρήστε τον χειριστή για το πρωτόκολλο editor:// στο σύστημα.

Αυτό γίνεται εκτελώντας το install.cmd. Πρέπει να το εκτελέσετε ως διαχειριστής. Το σενάριο open-editor.js θα εξυπηρετεί τώρα το πρωτόκολλο editor://.

Για να ανοίξετε συνδέσμους που δημιουργούνται σε άλλους διακομιστές, όπως ένας διακομιστής παραγωγής ή ο Docker, προσθέστε μια αντιστοίχιση απομακρυσμένης σε τοπική διεύθυνση URL στο open-editor.js:

	mappings: {
		// remote path: local path
		'/var/www/nette.app': 'W:\\Nette.web\\_web',
	}

Linux

  1. Κατεβάστε τα κατάλληλα αρχεία από το αποθετήριο Tracy στον κατάλογο ~/bin.
  2. Επεξεργαστείτε το open-editor.sh και ξεσχολιάστε ή επεξεργαστείτε τη διαδρομή προς τον επεξεργαστή σας στη μεταβλητή editor:
#!/bin/bash

# Emacs
#editor='emacs +$LINE "$FILE"'

# gVim
#editor='gvim +$LINE "$FILE"'

# gEdit
#editor='gedit +$LINE "$FILE"'

# Pluma
#editor='pluma +$LINE "$FILE"'

...

Κάντε το εκτελέσιμο:

chmod +x ~/bin/open-editor.sh

Αν ο επεξεργαστής που χρησιμοποιείτε δεν έχει εγκατασταθεί από το πακέτο, το δυαδικό αρχείο πιθανόν να μην έχει διαδρομή στο $PATH. Αυτό μπορεί να διορθωθεί εύκολα. Στον κατάλογο ~/bin, δημιουργήστε έναν συμβολικό σύνδεσμο στο δυαδικό αρχείο του επεξεργαστή.

3. Καταχωρήστε τον χειριστή για το πρωτόκολλο editor:// στο σύστημα.

Αυτό γίνεται με την εκτέλεση του install.sh. Το σενάριο open-editor.js θα εξυπηρετεί τώρα το πρωτόκολλο editor://.

macOS

Επεξεργαστές όπως το PhpStorm, το TextMate κ.λπ. σας επιτρέπουν να ανοίγετε αρχεία μέσω μιας ειδικής διεύθυνσης URL, την οποία απλώς πρέπει να ορίσετε:

// PhpStorm
Tracy\Debugger::$editor = 'phpstorm://open?file=%file&line=%line';
// TextMate
Tracy\Debugger::$editor = 'txmt://open/?url=file://%file&line=%line';
// MacVim
Tracy\Debugger::$editor = 'mvim://open/?url=file://%file&line=%line';
// Visual Studio Code
Tracy\Debugger::$editor = 'vscode://file/%file:%line';

Αν χρησιμοποιείτε το standalone Tracy, βάλτε τη γραμμή πριν από το Tracy\Debugger::enable(), αν το Nette, πριν από το $configurator->enableTracy() στο Bootstrap.php.

Δυστυχώς, οι ενέργειες create file ή fix it δεν λειτουργούν στο macOS.

Επιδείξεις

Διόρθωση σφάλματος:

Δημιουργία νέου αρχείου:

Αντιμετώπιση προβλημάτων

  • Στον Firefox μπορεί να χρειαστεί να επιτρέψετε την εκτέλεση προσαρμοσμένου πρωτοκόλλου στο about:config, ορίζοντας το network.protocol-handler.expose.editor σε false και το network.protocol-handler.expose-all σε true. Θα πρέπει να επιτρέπεται από προεπιλογή, ωστόσο.
  • Αν δεν λειτουργούν όλα αμέσως, μην πανικοβάλλεστε. Προσπαθήστε να ανανεώσετε τη σελίδα, να κάνετε επανεκκίνηση του προγράμματος περιήγησης ή του υπολογιστή. Αυτό θα πρέπει να βοηθήσει.
  • Δείτε εδώ για να το διορθώσετε:

    Σφάλμα εισόδου: Ίσως συσχετίσατε το αρχείο „.js“ με μια άλλη εφαρμογή, όχι με τη μηχανή JScript.

Ξεκινώντας από την έκδοση 77 του Google Chrome, δεν θα βλέπετε πλέον το πλαίσιο ελέγχου „Να ανοίγετε πάντα αυτούς τους τύπους συνδέσμων στη συνδεδεμένη εφαρμογή“ όταν ανοίγει ο επεξεργαστής μέσω ενός συνδέσμου. Αντιμετώπιση για τα Windows: δημιουργήστε το αρχείο fix.reg:

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\URLWhitelist]
"123"="editor://*"

Εισάγετε το με διπλό κλικ και επανεκκινήστε το Chrome.

Σε περίπτωση περισσότερων προβλημάτων ή ερωτήσεων, ρωτήστε στο φόρουμ.