Ενσωματωμένες βιβλιοθήκες frontend και άδειες τρίτων
Γνωρίστε τις ενσωματωμένες βιβλιοθήκες CSS και JavaScript της τυπικής έκδοσης της bluetronix. Μάθετε ποιες άδειες τρίτων είναι τεκμηριωμένες, πώς διατηρείς τα αρχεία standard ενημερώσιμα και ποιες επαληθεύσεις άδειας απαιτούνται πριν από την εκχώρηση.
Σκοπός του σεμιναρίου
Αυτή η τεκμηρίωση απευθύνεται σε προγραμματιστές και εξηγεί τις ενσωματωμένες βιβλιοθήκες frontend της έκδοσης bluetronix Standard, τους χώρους αποθήκευσης τους και τις αδειοδοτήσεις τρίτων που καταγράφονται στο πρότυπο.
Σημαντικό: Πριν από την παράδοση μιας έκδοσης, θα πρέπει να ελεγχθούν τα πραγματικά περιεχόμενα αρχεία, οι αρχικές σημειώσεις άδειας και οι ενδεχόμενες εμπορικές αποδείξεις άδειας. Οι εδώ αναφερόμενες εκδόσεις προέρχονται από αυτό το πρότυπο τεκμηρίωσης.
Το bluetronix CMS περιλαμβάνει στην τυπική έκδοση διάφορες εξωτερικές βιβλιοθήκες frontend για διάταξη, JavaScript λειτουργίες, slider, γκαλερί και animations.
Αυτές οι συνιστώσες ονομάζονται ενσωματωμένες βιβλιοθήκες frontend και διακρίνονται από τα πραγματικά modules του bluetronix CMS όπως το Blog, το Κατάστημα, η Αναζήτηση ή η Σύνδεση.
Τα αντίστοιχα πρότυπα αρχεία βρίσκονται ανάλογα με τον τύπο αρχείου μέσα στους καταλόγους συστήματος:
/bx_style/
/bx_script/
Σημαντικό: Οι κατάλογοι bx_style και bx_script ανήκουν στο σύστημα bluetronix. Τα πρότυπα αρχεία που περιέχονται σε αυτούς μπορεί να αντικατασταθούν ή να παρακαμφθούν από ενημερωμένες εκδόσεις κατά την ενημέρωση του bluetronix CMS.
Οποιαδήποτε προσωπική αλλαγή δεν θα πρέπει να γίνεται απευθείας μέσα σε αυτά τα πρότυπα αρχεία.
Για εξατομικευμένες προσαρμογές θα πρέπει να χρησιμοποιούνται δικά σας αρχεία ή αντίστοιχα επισημασμένα αρχεία _own.
Βιβλιοθήκες frontend που περιλαμβάνονται
| Βιβλιοθήκη | Έκδοση | Άδεια | Χρήση |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Responsive διάταξεις και στοιχεία CSS |
| jQuery | 3.7.1 | MIT | JavaScript και DOM λειτουργίες |
| Owl Carousel | 2.3.4 | MIT | Slider και Carousels |
| Swiper | 8.4.6 | MIT | Touch-Slider και responsive Carousels |
| WOW.js | 1.2.1 | MIT | Scroll και animation εισόδου |
| LightGallery | 1.6.2 | GPLv3 / Εμπορική Άδεια | Εικόνας και βίντεο-γκαλερί / Lightbox |
Bootstrap 5.3.3 CSS
Το Bootstrap παρέχει το responsive CSS θεμέλιο της τυπικής έκδοσης bluetronix.
Χρησιμοποιείται:
Bootstrap 5.3.3 CSS
Σημείωση: Η έκδοση JavaScript του Bootstrap (bootstrap.js) δεν είναι μέρος της τυπικής έκδοσης bluetronix.
Το Bootstrap προσφέρει μεταξύ άλλων τις εξής CSS λειτουργίες:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Άδεια: MIT Άδεια
Ο κώδικας του Bootstrap μπορεί να χρησιμοποιηθεί, να τροποποιηθεί και να διανεμηθεί σε εμπορικά και ιδιωτικά έργα, τηρώντας την MIT άδεια.
Οι σημειώσεις πνευματικών δικαιωμάτων και άδειας πρέπει να διατηρούνται στις αντίγραφες ή σε βασικά μέρη του λογισμικού.
jQuery 3.7.1
Το jQuery χρησιμοποιείται για διάφορες JavaScript και DOM λειτουργίες εντός του bluetronix CMS.
Χρησιμοποιούμενη έκδοση:
jQuery 3.7.1
Άδεια: MIT Άδεια
Το jQuery μπορεί να χρησιμοποιηθεί και να διανεμηθεί σε εμπορικά και ιδιωτικά έργα, τηρώντας την MIT άδεια.
Η υπάρχουσα σημείωση πνευματικών δικαιωμάτων και άδειας χρήσης θα πρέπει να παραμείνει μέσα στο παραδιδόμενο αρχείο jQuery.
Owl Carousel 2.3.4
Το Owl Carousel χρησιμοποιείται για απεικονίσεις slider και carousel.
Χρησιμοποιούμενη έκδοση:
Owl Carousel 2.3.4
Άδεια: MIT Άδεια
Η χρήση του Owl Carousel επιτρέπεται σε εμπορικά και ιδιόκτητα έργα, υπό την προϋπόθεση ότι τηρείται η άδεια MIT.
Σημείωση: Το επίσημο έργο Owl-Carousel-2 δεν αναπτύσσεται πλέον ενεργά. Η άδεια MIT της χρησιμοποιούμενης έκδοσης 2.3.4 παραμένει ανεπηρέαστη.
Swiper 8.4.6
Ο Swiper είναι μια βιβλιοθήκη touch και slider για responsive ιστοσελίδες.
Χρησιμοποιούμενη έκδοση:
Swiper 8.4.6
Ο Swiper μπορεί να χρησιμοποιηθεί για τις εξής λειτουργίες:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Άδεια: MIT Άδεια
Η χρησιμοποιούμενη έκδοση του Swiper μπορεί να χρησιμοποιηθεί και να διανεμηθεί σε εμπορικά και ιδιόκτητα έργα, υπό την προϋπόθεση ότι τηρείται η άδεια MIT.
WOW.js 1.2.1
Το WOW.js χρησιμοποιείται για να εμφανίζει στοιχεία κατά την κύλιση μιας ιστοσελίδας ή για να ενεργοποιεί CSS animations.
Χρησιμοποιούμενη έκδοση:
WOW.js 1.2.1
Η έκδοση που χρησιμοποιείται από την bluetronix περιέχει την εξής σημείωση άδειας:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MIT
Άδεια: MIT Άδεια
Σημαντικό: Για την bluetronix χρησιμοποιείται η παραλλαγή με άδεια MIT που συνεχίζει ο Thomas Grainger.
Αυτή η έκδοση μπορεί να χρησιμοποιηθεί και σε εμπορικά και ιδιόκτητα έργα υπό την προϋπόθεση ότι τηρείται η άδεια MIT.
LightGallery 1.6.2
Έλεγχος άδειας: Η συμπερίληψη του LightGallery σε αυτήν την επισκόπηση δεν σημαίνει ότι υπάρχει ήδη εμπορική άδεια για την συγκεκριμένη διανομή bluetronix. Πριν από μια ιδιόκτητη παράδοση, θα πρέπει να διευκρινιστεί και να καταγραφεί η νομική βάση της πραγματικά χρησιμοποιούμενης έκδοσης.
Το LightGallery χρησιμοποιείται στο σύστημα για γκαλερί εικόνας και βίντεο καθώς και για απεικονίσεις lightbox.
Χρησιμοποιούμενη έκδοση:
LightGallery 1.6.2
2017-10-03
Το χρησιμοποιούμενο αρχείο περιέχει την εξής σημείωση άδειας:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03
Άδεια: GNU General Public License Έκδοση 3 (GPLv3)
Σημαντικό: Το LightGallery έχει διαφορετικούς όρους άδειας από τις άλλες εδώ αναφερόμενες MIT βιβλιοθήκες.
Το έργο LightGallery διακρίνει:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial License
Για τη χρήση εντός μιας ιδιόκτητης διανομής bluetronix θα πρέπει να υπάρχει έγκυρη εμπορική άδεια LightGallery.
Εναλλακτικά, η χρήση θα πρέπει να είναι πλήρως συμβατή με τους όρους της GPLv3.
Σύσταση: Εάν η bluetronix παραδίδεται ιδιόκτητη στους πελάτες, το LightGallery θα πρέπει είτε να χρησιμοποιείται μέσω μιας αντίστοιχης εμπορικής άδειας ή να αντικαθίσταται από μια βιβλιοθήκη με άδεια κατάλληλη για ιδιόκτητη διανομή.
Θέσεις αποθήκευσης
Τα αρχεία βιβλιοθήκης αποθηκεύονται ανάλογα με τον τύπο αρχείου στους φακέλους του συστήματος bluetronix.
| Τύπος αρχείου | Φάκελος |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Βιβλιοθήκες όπως οι Owl Carousel, Swiper ή LightGallery μπορούν να έχουν τόσο αρχεία CSS όσο και JavaScript και επομένως να εκπροσωπούνται και στις δύο περιοχές του συστήματος.
Ενημερώσεις
Οι εντός του:
/bx_style/
/bx_script/
υπάρχουσες πρότυπες αρχεία διαχειρίζονται από το σύστημα ενημερώσεων bluetronix.
Κατά την ενημέρωση ενός CMS, αυτά τα αρχεία μπορεί να αντικατασταθούν από νεότερες εκδόσεις που προορίζονται από το bluetronix.
Έτσι μπορούν να παρασταθούν, για παράδειγμα, οι εξής ενημερώσεις:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Σημαντικό: Σε περίπτωση ενημέρωσης έκδοσης μιας βιβλιοθήκης τρίτου μέρους, πρέπει επιπλέον να ελεγχθεί αν έχουν αλλάξει οι όροι άδειας χρήσης.
Μην αλλάζετε απευθείας τα αρχεία προτύπων
Τα πρότυπα αρχεία που παρέχονται από το bluetronix δεν θα πρέπει να τροποποιούνται απευθείας.
Άμεσες τροποποιήσεις μπορεί να αντικατασταθούν κατά τη διάρκεια μελλοντικής ενημέρωσης του συστήματος.
Για ατομικές επεκτάσεις ισχύει συνεπώς:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden
Λάβετε σημειώσεις άδειας χρήσης
Οι υπάρχουσες σημειώσεις πνευματικών δικαιωμάτων και άδειας στα αρχεία τρίτων δεν θα πρέπει να αφαιρούνται.
Για παράδειγμα:
/*!
* Bootstrap ...
* Licensed under MIT
*/
ή:
/*! jQuery ...
* OpenJS Foundation ...
*/
θα πρέπει να παραμείνουν μέσα στα παραδιδόμενα αρχεία.
Άδειες τρίτων
Επιπλέον, είναι σκόπιμο να παρέχεται μέσα στη διανομή του bluetronix μια κεντρική επισκόπηση όλων των χρησιμοποιούμενων βιβλιοθηκών τρίτων.
Για παράδειγμα:
THIRD-PARTY-LICENSES.txt
Αυτό το αρχείο θα πρέπει να περιέχει τουλάχιστον τις εξής πληροφορίες:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Συνιστώμενο περιεχόμενο του αρχείου αδειών τρίτων
Bootstrap 5.3.3
License: MIT
Copyright: The Bootstrap Authors
jQuery 3.7.1
License: MIT
Copyright: OpenJS Foundation and other contributors
Owl Carousel 2.3.4
License: MIT
Copyright: David Deutsch
Swiper 8.4.6
License: MIT
Copyright: Vladimir Kharlampidi
WOW.js 1.2.1
License: MIT
Copyright: Thomas Grainger
LightGallery 1.6.2
License: GPLv3 or valid Commercial License
Copyright: Sachin N
Έλεγχος άδειας κατά τις ενημερώσεις
Δεδομένου ότι οι βιβλιοθήκες Frontend μπορούν να ενημερώνονται μέσω του συστήματος ενημερώσεων bluetronix, θα πρέπει πριν από την προσθήκη μιας νέας έκδοσης να ελέγχεται:
1. Welche Version wird ausgeliefert?
2. Welche Lizenz verwendet diese Version?
3. Ist die Lizenz mit einer proprietären bluetronix Distribution kompatibel?
4. Müssen Copyright- oder Lizenztexte mit ausgeliefert werden?
5. Benötigt die Bibliothek eine zusätzliche kommerzielle Lizenz?
6. Hat sich die Lizenz gegenüber der vorherigen Version geändert?
Μόνο τότε θα πρέπει να γίνει υιοθέτηση μιας νέας έκδοσης ως πρότυπης βιβλιοθήκης σε bx_style ή bx_script.
Επισκόπηση άδειας για την τρέχουσα έκδοση bluetronix Standard
| Βιβλιοθήκη | Έκδοση | Άδεια | Ιδιόκτητη χρήση |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Ναι, υπό την προϋπόθεση της άδειας MIT |
| jQuery | 3.7.1 | MIT | Ναι, υπό την προϋπόθεση της άδειας MIT |
| Owl Carousel | 2.3.4 | MIT | Ναι, υπό την προϋπόθεση της άδειας MIT |
| Swiper | 8.4.6 | MIT | Ναι, υπό την προϋπόθεση της άδειας MIT |
| WOW.js | 1.2.1 | MIT | Ναι, υπό την προϋπόθεση της άδειας MIT |
| LightGallery | 1.6.2 | GPLv3 / Εμπορική | Για ιδιοκτησιακή διανομή, χρησιμοποιήστε άδεια Commercial License |
Περίληψη
Η πρότυπη έκδοση bluetronix περιέχει τις εξής εξωτερικές βιβλιοθήκες Frontend:
Bootstrap CSS 5.3.3
jQuery 3.7.1
Owl Carousel 2.3.4
Swiper 8.4.6
WOW.js 1.2.1
LightGallery 1.6.2
Οι Bootstrap, jQuery, Owl Carousel, Swiper και η χρησιμοποιούμενη έκδοση WOW.js υπόκεινται στην άδεια MIT.
Οι αντίστοιχες σημειώσεις πνευματικών δικαιωμάτων και άδειας πρέπει να διατηρηθούν.
Το LightGallery 1.6.2 είναι διαθέσιμο υπό GPLv3 και μπορεί επίσης να αδειοδοτηθεί μέσω μιας εμπορικής άδειας για ιδιωτικές εφαρμογές.
Για μια ιδιωτική διανομή bluetronix, πρέπει να ισχύουν τα εξής:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzen
Με κάθε μελλοντική ενημέρωση μιας βιβλιοθήκης τρίτου προμηθευτή, πρέπει να ελέγχονται ξανά η έκδοση και η άδεια πριν από την παράδοση της νέας έκδοσης μέσω του συστήματος ενημέρωσης bluetronix.
Συχνές Ερωτήσεις
τι ρωτούν συχνά οι πελάτες μας
Τι είναι οι ενσωματωμένες βιβλιοθήκες frontend;
Είναι εξωτερικές βιβλιοθήκες CSS και JavaScript που χρησιμοποιούνται στην τυπική έκδοση bluetronix για διατάξεις, sliders, γκαλερί και animations. Δεν είναι αυτόνομα CMS modules όπως Blog ή Shop.
Ποιες frontend βιβλιοθήκες αναφέρει αυτή η τεκμηρίωση;
Η πρότυπη αναφέρει τις Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 και LightGallery 1.6.2. Πριν από την παράδοση, θα πρέπει να συγκρίνεις τις εγκατεστημένες εκδόσεις με τα πραγματικά αρχεία.
Είναι το Bootstrap-JavaScript περιεχόμενο στο τυπικό σύστημα bluetronix;
Όχι. Σύμφωνα με το πρότυπο, το Bootstrap 5.3.3 χρησιμοποιείται αποκλειστικά ως CSS; το bootstrap.js δεν είναι μέρος της τυπικής έκδοσης.
Που βρίσκονται τα CSS και JavaScript αρχεία που περιέχονται κατά προεπιλογή;
Τα CSS αρχεία βρίσκονται στο /bx_style/ και τα JavaScript αρχεία στο /bx_script/. Οι βιβλιοθήκες μπορεί να περιέχουν αρχεία και στους δύο καταλόγους.
Μπορώ να τροποποιήσω απευθείας τα αρχεία συστήματος;
Τα τυπικά αρχεία στο bx_style και bx_script μπορούν να αντικατασταθούν κατά τις ενημερώσεις. Χρησιμοποίησε χωριστά αρχεία έργου ή αντίστοιχα επισημασμένα αρχεία _own για τις δικές σου επεκτάσεις.
Ποιες από τις αναφερόμενες βιβλιοθήκες χρησιμοποιούν την άδεια MIT;
Το πρότυπο αναφέρει τις Bootstrap CSS, jQuery, Owl Carousel, Swiper και την παραλλαγή του WOW.js που συνεχίζει ο Thomas Grainger. Έλεγξε τις σημειώσεις άδειας στα πραγματικά παραδιδόμενα αρχεία.
Ποια είναι η ιδιαιτερότητα του LightGallery 1.6.2;
Η τεκμηριωμένη έκδοση χρησιμοποιεί GPLv3 ή μια εμπορική άδεια. Για μια ιδιωτική διανομή, πρέπει να ελέγξεις αν υπάρχει κατάλληλη εμπορική άδεια ή αν η συγκεκριμένη χρήση είναι πλήρως συμβατή με την GPLv3.
Είναι δυνατή η εμπορική χρήση με την άδεια MIT;
Ναι, εφόσον τηρούνται οι όροι της άδειας MIT. Αυτό περιλαμβάνει συγκεκριμένα τη διατήρηση των απαιτούμενων σημειώσεων πνευματικών δικαιωμάτων και άδειας σε αντίγραφα ή ουσιώδη μέρη.
Πώς καταγράφω τις άδειες τρίτων;
Το πρότυπο προτείνει ένα κεντρικό αρχείο THIRD-PARTY-LICENSES.txt. Σε αυτό θα πρέπει να αναγράφονται το όνομα, η έκδοση, ο δημιουργός ή το έργο, η άδεια και μια αναφορά στο αντίστοιχο κείμενο άδειας.
Τι πρέπει να ελέγξω κατά την ενημέρωση μιας βιβλιοθήκης;
Έλεγξε την πραγματικά παραδιδόμενη έκδοση, το κείμενο άδειας της, τη συμβατότητα με τη προβλεπόμενη διανομή και την υποχρέωση να παρέχεις πληροφορίες άδειας ή πνευματικών δικαιωμάτων. Διευκρίνισε αν χρειάζεται ξεχωριστή εμπορική άδεια.
Θα διατηρηθούν οι αυτοδημιούργητες _own αρχεία κατά τις ενημερώσεις συστήματος;
Η σύμβαση _own είναι σχεδιασμένη για να χωρίζει τα προσωπικά αρχεία από τα τυπικά αρχεία. Αυτό προστατεύει τις ατομικές τροποποιήσεις από το να ενημερώνονται όπως οι κανονικές αρχεία συστήματος; ωστόσο, η διαχείριση και η ενσωμάωση σχετικών ενημερώσεων ασφαλείας παραμένει ευθύνη του προγραμματιστή.
Είναι οι βιβλιοθήκες τρίτων κατασκευαστών το ίδιο με τα CMS modules;
Όχι. Οι βιβλιοθήκες frontend παρέχουν, για παράδειγμα, CSS layouts, sliders ή λειτουργίες γκαλερί. Τα CMS modules όπως μπλογκ, κατάστημα, αναζήτηση και σύνδεση είναι ξεχωριστές λειτουργίες εφαρμογών του bluetronix CMS.