---
title: "Μεταφορά τεκμηρίωσης Look Scanned How-To στο VitePress με βελτιωμένη ασφάλεια"
description: "Ανακαλύψτε πώς το Look Scanned αναβάθμισε την υποδομή τεκμηρίωσής του μεταφέροντας από Vue + Vite σε VitePress, ενώ ταυτόχρονα υλοποίησε npm Trusted Publishers με OIDC για ασφαλείς, χωρίς token εκδόσεις πακέτων."
date: 2025-12-19T07:55:33.000Z
lang: el
source: https://lookscanned.io/el/blog/migrating-look-scanned-how-to-to-vitepress
tags: ["vitepress", "τεκμηρίωση", "ασφάλεια", "cicd", "npm"]
---

# Μεταφορά τεκμηρίωσης Look Scanned How-To στο VitePress με βελτιωμένη ασφάλεια

Στο [Look Scanned](https://lookscanned.io), βελτιώνουμε συνεχώς την υποδομή μας για να παρέχουμε καλύτερη τεκμηρίωση και πιο ασφαλείς πρακτικές ανάπτυξης. Σήμερα, είμαστε ενθουσιασμένοι να μοιραστούμε λεπτομέρειες σχετικά με μια σημαντική αναβάθμιση στον ιστότοπο τεκμηρίωσης How-To: τη μεταφορά από μια προσαρμοσμένη εφαρμογή Vue + Vite σε VitePress, ενώ ταυτόχρονα ενισχύουμε την ασφάλεια CI/CD μας με npm Trusted Publishers.

## 📚 Γιατί μεταφερθήκαμε στο VitePress

Ο ιστότοπος τεκμηρίωσης How-To μας ([github.com/lookscanned/how-to](https://github.com/lookscanned/how-to)) λειτουργεί ως ολοκληρωμένος οδηγός χρήσης για το Look Scanned. Ενώ η προηγούμενη ρύθμιση Vue + Vite λειτουργούσε καλά, αναγνωρίσαμε ότι το VitePress θα ήταν καλύτερη επιλογή για έναν ιστότοπο τεκμηρίωσης με επίκεντρο το περιεχόμενο.

### Τι είναι το VitePress;

Το VitePress είναι ένας γεννήτορας στατικών ιστοτόπων σχεδιασμένος ειδικά για τεκμηρίωση. Χτισμένο πάνω στο Vite και Vue 3, συνδυάζει το καλύτερο και από τους δύο κόσμους: εμπειρία ανάπτυξης με ταχύτητα φωτός με ισχυρές λειτουργίες τεκμηρίωσης έτοιμες προς χρήση.

### Βασικά οφέλη της μεταφοράς

**🎯 Καλύτερη αρχιτεκτονική για τεκμηρίωση**
- **Δρομολόγηση βασισμένη σε αρχεία**: Κάθε αρχείο markdown γίνεται αυτόματα μια σελίδα, καθιστώντας την οργάνωση περιεχομένου διαισθητική
- **Ενσωματωμένες λειτουργίες τεκμηρίωσης**: Πίνακας περιεχομένων, αναζήτηση, διεθνοποίηση και άλλα έρχονται προρυθμισμένα
- **Δημιουργία στατικού ιστοτόπου**: Το προ-αποδοθέν HTML παρέχει εξαιρετικό SEO και άμεση φόρτωση σελίδων

**⚡ Βελτιωμένη εμπειρία προγραμματιστή**
- **Άμεση ενεργή επαναφόρτωση**: Οι αλλαγές εμφανίζονται αμέσως κατά την ανάπτυξη
- **Markdown πρώτα**: Εστιάστε στο περιεχόμενο, όχι στο σκελετό στοιχείων
- **Υποστήριξη στοιχείων Vue**: Όταν χρειάζεται, μπορούμε ακόμα να χρησιμοποιήσουμε προσαρμοσμένα στοιχεία Vue μέσα στο markdown

**🔧 Ευκολότερη συντήρηση**
- **Σαφέστερη δομή**: Η τεκμηρίωση ακολουθεί συμβάσεις, μειώνοντας το γνωστικό φορτίο για τους συνεισφέροντες
- **Πιο σταθερές κατασκευές**: Η δομή με γνώμη του VitePress οδηγεί σε πιο αναπαραγώγιμες κατασκευές
- **Καλύτερη συνεργασία**: Τα μέλη της ομάδας μπορούν να συνεισφέρουν στην τεκμηρίωση χωρίς βαθιά γνώση Vue

## 🔒 Βελτιωμένη ασφάλεια με npm Trusted Publishers

Παράλληλα με τη μεταφορά VitePress, υλοποιήσαμε μια κρίσιμη βελτίωση ασφαλείας: **npm Trusted Publishers χρησιμοποιώντας επικύρωση OIDC**.

### Το πρόβλημα με τα παραδοσιακά npm tokens

Προηγουμένως, η δημοσίευση πακέτων στο npm απαιτούσε την αποθήκευση ενός μακράς διάρκειας `NPM_TOKEN` στα μυστικά του αποθετηρίου. Αυτή η προσέγγιση έχει αρκετά μειονεκτήματα:

- **Κίνδυνος ασφαλείας**: Τα tokens μπορούν να εκτεθούν κατά λάθος ή να παραβιαστούν
- **Επιβάρυνση διαχείρισης**: Τα tokens χρειάζονται χειροκίνητη εναλλαγή και ενημερώσεις
- **Προκλήσεις ελέγχου**: Δύσκολο να παρακολουθήσετε ποιος δημοσίευσε τι και πότε

### Η λύση: Έμπιστη δημοσίευση βασισμένη σε OIDC

Οι [npm Trusted Publishers](https://docs.npmjs.com/trusted-publishers/) αξιοποιούν το OpenID Connect (OIDC) για να επιτρέψουν ασφαλή δημοσίευση χωρίς token απευθείας από το GitHub Actions. Δείτε πώς λειτουργεί:

1. **Κανένα αποθηκευμένο μυστικό**: Αντί να αποθηκεύει tokens, το GitHub Actions ζητά διαπιστευτήρια σύντομης διάρκειας από το npm
2. **Επαλήθευση ταυτότητας**: Το npm επαληθεύει ότι το αίτημα δημοσίευσης προήλθε από το εξουσιοδοτημένο αποθετήριο GitHub
3. **Αυτόματη διαχείριση διαπιστευτηρίων**: Τα διαπιστευτήρια εκδίδονται αυτόματα και λήγουν γρήγορα

### Πραγματικά οφέλη

Αυτή η αλλαγή φέρνει άμεσες βελτιώσεις στη ροή εργασίας ανάπτυξής μας:

- ✅ **Όχι άλλη διαχείριση tokens**: Δεν χρειάζεται να δημιουργήσετε, να αποθηκεύσετε ή να εναλλάσσετε npm tokens
- ✅ **Μειωμένη επιφάνεια επίθεσης**: Τα διαπιστευτήρια σύντομης διάρκειας ελαχιστοποιούν τον κίνδυνο έκθεσης
- ✅ **Καλύτερη δυνατότητα ελέγχου**: Κάθε ενέργεια δημοσίευσης είναι συνδεδεμένη με μια συγκεκριμένη εκτέλεση GitHub Actions
- ✅ **Σύγχρονες βέλτιστες πρακτικές**: Ευθυγραμμίζεται με τις αρχές ασφαλείας μηδενικής εμπιστοσύνης

**Τεχνική σημείωση**: Για να υποστηρίξουμε npm Trusted Publishers, ενημερώσαμε τη διαμόρφωση CI μας για να χρησιμοποιεί Node.js `lts/*`, διασφαλίζοντας ότι έχουμε την πιο πρόσφατη έκδοση npm που απαιτείται για επικύρωση OIDC.

## 📦 Χρονοδιάγραμμα έκδοσης

Η μεταφορά ολοκληρώθηκε μέσω τριών εκδόσεων στις 19 Δεκεμβρίου 2025:

- **v2.0.0**: Βασική μεταφορά από Vue + Vite σε VitePress (αλλαγή που σπάει)
- **v2.0.1**: Διόρθωση CI για υποστήριξη npm Trusted Publishers με κατάλληλη έκδοση Node.js
- **v2.0.2**: Βελτίωση απόδοσης μετακινώντας το `@fontsource/noto-mono` στα devDependencies

## 🌍 Συνεχής πολυγλωσσική υποστήριξη

Μια σημαντική σημείωση: η τεκμηρίωση How-To μας δημιουργεί πολυγλωσσικά PDF που έχουν πάντα χρησιμοποιηθεί ως δείγματα αρχείων στην κύρια εφαρμογή Look Scanned (διαθέσιμο στο [lookscanned.io/en/scan](https://lookscanned.io/en/scan)). Αυτή η μεταφορά VitePress δεν αλλάζει αυτή τη λειτουργικότητα—απλά παρέχει καλύτερη βάση για τη συντήρηση και βελτίωση της υποδομής τεκμηρίωσής μας.

## 💡 Τι σημαίνει αυτό για τους χρήστες

Εάν χρησιμοποιείτε την τεκμηρίωση του Look Scanned:

- **Ίδια πρόσβαση, καλύτερη εμπειρία**: Η τεκμηρίωση παραμένει στο ίδιο URL με βελτιωμένη φόρτωση και πλοήγηση
- **Πιο αξιόπιστη**: Η δημιουργία στατικού ιστοτόπου σημαίνει ταχύτερες φορτώσεις και καλύτερη σταθερότητα
- **Καλύτερη αναζήτηση και ανακάλυψη**: Η ενσωματωμένη αναζήτηση του VitePress σας βοηθά να βρείτε απαντήσεις πιο γρήγορα
- **Συνεχής υποστήριξη PDF**: Η δημιουργία πολυγλωσσικών PDF συνεχίζεται όπως πριν

## 🚀 Τι έρχεται

Με την αναβάθμιση της υποδομής να ολοκληρώνεται, εστιάζουμε σε βελτιώσεις περιεχομένου:

- **Επεκταμένες περιπτώσεις χρήσης**: Περισσότερα πρακτικά παραδείγματα και βήμα-βήμα οδηγοί
- **Βελτιώσεις συνέπειας**: Βελτίωση πολυγλωσσικής ορολογίας για σαφήνεια
- **Βελτιωμένη εξαγωγή PDF**: Βελτίωση της εμπειρίας δημιουργίας PDF σε διάφορους περιηγητές

## Δοκιμάστε το Look Scanned σήμερα

Το Look Scanned παρέχει εφέ σάρωσης PDF βασισμένα σε περιηγητή, με προτεραιότητα στο απόρρητο, χωρίς να ανεβάζετε τα αρχεία σας πουθενά. Η βελτιωμένη τεκμηρίωση κάνει την έναρξη ευκολότερη από ποτέ.

👉 **Επισκεφθείτε το [lookscanned.io](https://lookscanned.io) για να βιώσετε γρήγορη, ασφαλή σάρωση εγγράφων στον περιηγητή σας.**