Εξαγωγή

Διαφάνειες

PDF

Η εξαγωγή σε PDF, PPTX ή PNG βασίζεται στο Playwright για την απεικόνιση. Επομένως, θα πρέπει να εγκαταστήσετε το playwright-chromium για να χρησιμοποιήσετε αυτή τη λειτουργία. Αν κάνετε εξαγωγή σε περιβάλλον CI, μπορεί να σας φανεί χρήσιμος ο οδηγός CI του playwright.

1. Εγκαταστήστε playwright-chromium

$ npm i -D playwright-chromium

2. Τώρα εξάγετε τις διαφάνειές σας σε PDF χρησιμοποιώντας την ακόλουθη εντολή:

$ slidev export

Μετά από λίγα δευτερόλεπτα, οι διαφάνειές σας θα είναι έτοιμες στο ./slides-export.pdf.

PNGs και Markdown

Αν δώσετε την επιλογή --format png, το Slidev θα εξάγει εικόνες PNG για κάθε διαφάνεια αντί για ένα αρχείο PDF:

$ slidev export --format png

Μπορείτε επίσης να δημιουργήσετε ένα αρχείο markdown που αποτελείται από αρχεία png χρησιμοποιώντας το --format md:

$ slidev export --format md

PPTX (Microsoft PowerPoint)

Το Slidev μπορεί επίσης να εξάγει τις διαφάνειές σας ως αρχείο PPTX:

$ slidev export --format pptx

Σημειώστε ότι όλες οι διαφάνειες στο αρχείο PPTX θα εξαχθούν ως εικόνες, οπότε το κείμενο δεν θα μπορεί να επιλεγεί. Οι σημειώσεις του παρουσιαστή θα μεταφέρονται στο αρχείο PPTX ανά διαφάνεια.

Σε αυτή τη λειτουργία, η επιλογή --with-clicks είναι ενεργοποιημένη από προεπιλογή. Για να την απενεργοποιήσετε, χρησιμοποιήστε την επιλογή --with-clicks false.

Dark mode

Σε περίπτωση που θέλετε να εξάγετε τις διαφάνειές σας χρησιμοποιώντας τη σκοτεινή έκδοση του θέματος, χρησιμοποιήστε την επιλογή --dark:

$ slidev export --dark

Εξαγωγή Βημάτων Clicks

Διαθέσιμο από v0.21

Εξ ορισμού, το Slidev εξάγει μία σελίδα ανά διαφάνεια με απενεργοποιημένες τις κινήσεις click. Εάν θέλετε να εξάγετε διαφάνειες με πολλαπλά βήματα σε πολλαπλές σελίδες, περάστε την επιλογή --with-clicks:

$ slidev export --with-clicks

PDF outline

Διαθέσιμο από v0.36.10

Μπορείτε να δημιουργήσετε το PDF outline περνώντας την επιλογή --with-toc:

$ slidev export --with-toc

Όνομα αρχείου εξόδου

Μπορείτε να καθορίσετε το όνομα του αρχείου εξόδου με την επιλογή --output:

$ slidev export --output my-pdf-export

Ή στη ρύθμιση frontmatter:

---
exportFilename: my-pdf-export
---

Εξαγωγή ενός εύρους διαφανειών

Από προεπιλογή, όλες οι διαφάνειες της παρουσίασης εξάγονται. Αν θέλετε να εξάγετε μια συγκεκριμένη διαφάνεια ή ένα εύρος διαφανειών, μπορείτε να ορίσετε την επιλογή --range και να καθορίσετε ποιες διαφάνειες θέλετε να εξαχθούν:

$ slidev export --range 1,6-8,10

Αυτή η επιλογή δέχεται συγκεκριμένους αριθμούς διαφανειών και εύρη τιμών.

Το παραπάνω παράδειγμα θα εξάγει τις διαφάνειες 1,6,7,8 και 10.

Πολλαπλές καταχωρήσεις

Μπορείτε επίσης να εξάγετε πολλές διαφάνειες ταυτόχρονα:

$ slidev export slides1.md slides2.md

Ή

$ slidev export *.md

Σε αυτή την περίπτωση, κάθε αρχείο εισόδου θα δημιουργήσει το δικό του αρχείο PDF.

Σημειώσεις παρουσιαστή

Διαθέσιμο από v0.36.8

Εξάγετε μόνο τις σημειώσεις του παρουσιαστή (το τελευταίο block σχολίων για κάθε διαφάνεια) σε ένα έγγραφο κειμένου σε PDF:

$ slidev export-notes

Αυτή η εντολή δέχεται επίσης πολλαπλές καταχωρήσεις όπως και η εντολή export

Single-Page Application (SPA)

Δείτε την Στατική Φιλοξενία.

Εξαγώγιμο Docker Image

Για την υποστήριξη της δυνατότητας εξαγωγής, υπάρχει ένα docker image (που συντηρείται από τον @tangramor) με την ετικέτα playwright. Εκτελέστε την ακόλουθη εντολή στο φάκελο εργασίας σας:

docker run --name slidev --rm -it \
    -v ${PWD}:/slidev \
    -p 3030:3030 \
    -e NPM_MIRROR="https://registry.npmmirror.com" \
    tangramor/slidev:playwright

Στη συνέχεια, μπορείτε να χρησιμοποιήσετε τη λειτουργία εξαγωγής, όπως παρακάτω, στο φάκελο εργασίας σας:

docker exec -i slidev npx slidev export --timeout 2m --output slides.pdf

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

Timeouts

Για μεγάλες παρουσιάσεις μπορεί να θέλετε να αυξήσετε το χρονικό όριο του Playwright με το --timeout:

$ slidev export --timeout 60000

Wait

Ορισμένα τμήματα των διαφανειών σας μπορεί να χρειαστούν περισσότερο χρόνο για να απεικονιστούν. Μπορείτε να χρησιμοποιήσετε την επιλογή --wait για να έχετε μια επιπλέον καθυστέρηση πριν από την εξαγωγή:

$ slidev export --wait 10000

Υπάρχει επίσης η επιλογή --wait-until για να περιμένετε ένα αποτέλεσμα πριν την εξαγωγή κάθε διαφάνειας:

$ slidev export --wait-until none

Πιθανές τιμές:

• 'networkidle' - (προεπιλογή) θεωρεί ότι η λειτουργία έχει ολοκληρωθεί όταν δεν υπάρχουν συνδέσεις δικτύου για τουλάχιστον 500 ms. Μην χρησιμοποιείτε αυτή τη μέθοδο για δοκιμές, βασιστείτε στις βεβαιώσεις ιστού για να προσδιορίσετε την ετοιμότητα.
• 'domcontentloaded' - θεωρεί ότι η λειτουργία έχει ολοκληρωθεί όταν ενεργοποιηθεί το event DOMContentLoaded.
• 'load' - θεωρεί ότι η λειτουργία έχει ολοκληρωθεί όταν ενεργοποιηθεί το event load.
• 'none' - δεν περιμένει για κάποιο event.

WARNING

Όταν καθορίζετε τιμές εκτός από 'networkidle', βεβαιωθείτε ότι οι ορατές διαφάνειες είναι πλήρεις και σωστές. Εάν λείπουν κάποια περιεχόμενα, ίσως χρειαστεί να χρησιμοποιήσετε την επιλογή --wait.

Executable path

Το Chromium ενδέχεται να μην διαθέτει ορισμένες λειτουργίες, όπως κωδικοποιητές που απαιτούνται για την αποκωδικοποίηση ορισμένων βίντεο. Μπορείτε να ορίσετε τη διαδρομή εκτέλεσης του προγράμματος περιήγησης για το Playwright στο Chrome ή τον Edge χρησιμοποιώντας το --executable-path:

$ slidev export --executable-path [διαδρομή_προς_το_chromium]