lazygal - מקוון בענן

תָכְנִית:

שֵׁם

lazygal - מחולל גלריית אינטרנט סטטית

תַקצִיר

lazygal [-h | -v | [אפשרויות] albumdir]

תיאור

דף מדריך זה מסביר את lazygal תכנית. תוכנית זו היא גלריית אינטרנט סטטית
מחולל כתוב בפייתון.

lazygal עובד כך: צריך להיות לך מאגר מקורי של קבצים - אולי מכיל
ספריות משנה (שמותיהן משמשים ככותרות אם לא משתמשים בתכונת המטא נתונים של האלבום).
זוהי היררכיית קבצי המקור. זה לעולם לא ישונה על ידי lazygal. אז מתי
הַשָׁקָה:

$ lazygal -o /var/www/MyAlbum /home/user/SourceDir

lazygal ינתח את תוכן היררכיית המקור וייצור (מחדש) את היעד
היררכיה, עם כל הפעמונים והשריקות המוגדרות על ידי התבניות. רק חלקים חסרים או
ייווצרו חלקים שאינם מעודכנים. יש מגבלה למנגנון הזה
אם כי: למרות שעדכונים בספריית המקור, במטא נתונים או בערכות הנושא
זוהה, שינויים באפשרויות שורת הפקודה ובקבצי התצורה מאז הדור האחרון
אינם והמשתמש צריך למחוק ידנית קבצים שיש ליצור שוב.

אפשרויות

תוכניות אלה עוקבות אחר תחביר שורת הפקודה הרגיל של GNU, עם אפשרויות ארוכות שמתחילות ב
שני מקפים (`-'). סיכום האפשרויות כלול להלן. לתיאור מלא, ראה
מה היא -h מתג.

-v --גִרְסָה
הצג את מספר הגרסה של התוכנית וצא.

-h - עזרה
הצג סיכום של אפשרויות.

--שֶׁקֶט
אל תוציא שום דבר מלבד שגיאות.

--לנפות
פלט את כל מה ש-lazygal עושה.

-o DEST_DIR --output-directory=DEST_DIR
ספרייה שבה ייכתבו דפי אינטרנט, שקופיות ואגודלים (ברירת המחדל היא עדכנית
מַדרִיך).

-t THEME --נושא=THEME
שם ערכת הנושא (נחפש בספריית ערכות הנושא) או נתיב מלא של ערכת הנושא.

--default-style=DEFAULT_STYLE
סגנון ברירת מחדל להחלה על ערכת הנושא.

--template-vars=TPL_VARS
משתנים נפוצים לטעינת כל התבניות, למשל --template-vars='footer=foo
bar,color=baz'. עבור תוכן משתנה ארוך יותר, קל יותר להשתמש בקובץ תצורה
(ראה lazygal.conf(5)).

-f --force-gen-pages
לאלץ בנייה מחדש של דפי אינטרנט, ללא קשר לזמני השינוי שלהם
תלות. זה שימושי כאשר משנים אפשרות תצורה המשפיעה על אלה
(נושא, שיטוח ספריות וכו').

--יעד נקי
נקה את ספריית היעד של קבצים שלא צריכים להיות שם (ברירת המחדל היא להדפיס א
אזהרה אך לא למחוק).

--בדוק-כל-dirs
עברו באופן ממצה על כל הספריות ללא קשר לזמן שינוי המקור.

-s גודל תמונה --גודל תמונה=גודל תמונה
גודל התמונות, הגדר כ שם=xxy, ..., למשל. קטן=800x600, בינוני=1024x768. ה
מידות מיוחדות 0x0 השתמש בגודל המקורי. עיין בתיאור שינוי גודל התמונה
למידע נוסף על התחביר הזמין.

-T THUMBNAIL_SIZE --גודל תמונה ממוזערת=THUMBNAIL_SIZE
גודל של תמונות ממוזערות, למשל. 150x113. עיין בסעיף תיאור שינוי גודל תמונה עבור
מידע נוסף על התחביר הזמין.

-q איכות --איכות=איכות
איכות תמונות JPEG שנוצרו (ברירת המחדל היא 85).

-O --מְקוֹרִי
כלול תמונות מקוריות בפלט.

--orig-base=RELATIVE_PATH
אל תעתיק תמונות מקוריות בספריית הפלט, אלא קשר אותן באמצעות RELATIVE_PATH
כבסיס לקישורים הללו (הושלך ללא -O).

--orig-symlink
אל תעתיק תמונות מקוריות בספריית הפלט, במקום זאת צור קישורים סימליים אליהן
מיקומים מקוריים. זה שימושי כאשר אתה מתכנן להעביר את כל הספרייה
אשר lazygal נוצר למקום אחר, אולי עם rsync, ואתה רוצה
הימנע מיצירת עותק נוסף של כל תמונה.

זהירות
אפשרות זו אינה זמינה ב-Windows; אם תנסה להשתמש בו בהפעלה זו
מַעֲרֶכֶת, lazygal ייצא מיד עם סטטוס יציאה של 1.

--puburl=PUB_URL
כתובת אתר לפרסום (שימושי רק ליצירת עדכונים).

-m --generate-metadata
צור במקום זאת קבצי תיאור של מטא נתונים שבהם הם לא קיימים בעץ המקור
של יצירת גלריית האינטרנט. זה משבית את כל האפשרויות האחרות.

-n THUMBS_PER_PAGE --thumbs-to-page=THUMBS_PER_PAGE
מספר אגודלים מקסימלי לכל דף אינדקס. זה מאפשר עימוד אינדקס (0 הוא
ללא הגבלה).

--filter-by-tag=תָג
אם מוגדר, lazygal ייצא רק את התמונות שיש להן אחד מהתגים (IPTC) שלהן
תואם TAG. אפשר גם להשתמש במקביל של בדיקות AND ו-OR בוליאניות
תגי סינון. לפרטים נוספים, קרא מתחת לסעיף תָג סינון.

--pic-sort-by=להזמין
סדר מיון של תמונות בתת-גלריה, בין 'mtime', 'filename' או 'exif'. (בְּרִירַת מֶחדָל
הוא 'exif' שהוא לפי תאריך EXIF ​​אם נתוני EXIF ​​זמינים, שם הקובץ אחרת, מיון
תמונות ללא EXIF ​​לפני). הוסף ':reverse' כדי להפוך את סדר המיון (למשל
--pic-sort-by=mtime:reverse).

--subgal-sort-by=להזמין
סדר מיון עבור תת-גלריות, בין 'exif' (תאריך EXIF ​​של התמונה האחרונה ב
תת-גלריה), 'mtime' או 'dirname' (ברירת המחדל היא 'dirname'). הוסף ':reverse' כדי להפוך
סדר המיון (למשל --subgal-sort-by=dirname:reverse).

--dir-plattinging-depth=רמה
רמה שמתחתיה משטח עץ הספריות. ברירת המחדל היא אי השטחה ('לא').

אפשרות זו גורמת לתוכנית לכלול את אינדקס גלריית האינטרנט של גלריות ילדים
אינדקס הגלריה של ההורים שלהם, אם הרמה שלהם גדולה מהמדד שסופק רמה. ה
רמת שורש האלבום היא 0.

דפי אינדקס עם גלריות מרובות (מה שקורה כשמשתמשים בקטע זה) מציגים את
קישורי תמונות בחלקי הגלריה.

הדוגמאות הבאות מציגות את האינדקסים שהופקו עבור אלבום לדוגמה (2 תת-גלריות,
תת-תת-גלריה אחת, תמונה אחת בכל אחת מהן).

דוגמה 1. --dir-flatening-depth=לא (ברירת מחדל)

index.html <- קישורי תת-גלריה
subgal1/index.html <- אינדקס עם img1
subgal1/img1.html
subgal1/subsubgal1/index.html <- index with img2
subgal1/subsubgal1/img2.html
subgal2/index.html <- אינדקס עם img3
subgal2/img3.html

דוגמה 2. --dir-plattinging-depth=0

index.html <- מכיל אינדקס עבור כל התמונות
subgal1/img1.html
subgal1/subsubgal1/img2.html
subgal2/img3.html

דוגמה 3. --dir-plattinging-depth=1

index.html <- מכיל אינדקס עבור כל התמונות
subgal1/index.html <- index עם img1 ו-img2
subgal1/img1.html
subgal1/subsubgal1/img2.html
subgal2/index.html <- אינדקס עם img3
subgal2/img3.html

-z --make-dir-zip
צור ארכיון zip של תמונות מקוריות עבור כל ספרייה.

--webalbum-pic-bg=WEBALBUMPIC_BG
צבע רקע של תמונת אלבום אינטרנט. ברירת המחדל היא שקופה, ומרמזת על פורמט PNG.
כל ערך אחר, למשל אדום, לבן, כחול, משתמש ב-JPEG.

--webalbum-pic-type=WEBALBUMPIC_TYPE
איזה סוג של תמונות ממוזערות של אלבומי אינטרנט ליצור. כברירת מחדל, lazygal יוצר את
תמונות ממוזערות "מבולגנות" אהובות עם תמונות שנבחרו באקראי מהאלבום כל אחת
סובב בכמות אקראית והודבק יחד. ניתן לכפות ברירת מחדל זו גם על ידי
ציון 'מבולגן' בתור WEBALBUMPIC_TYPE.

מצד שני, ציון 'מסודר' כערך של אפשרות זו מאלץ את lazygal
לדלג על הסיבובים, וכתוצאה מכך תמונות ממוזערות בעלות צורה קבועה יותר שיכולות גם להיות
צפוף יותר. זה יכול להיות יתרון אם לא לכל המשתמשים באלבומים שלך יש
מסכים ענקיים :-)

--שמור-gps-data
אל תסיר נתוני GPS מתגי EXIF. כברירת מחדל, תגי המיקום מוסרים עבור
סיבות פרטיות. עם זאת, ישנם מצבים שבהם נתוני המיקום עושים
חוש ורצוי. זה נועד בעיקר לשמש עם תמונות חג.

ערכות נושא

ערכת נושא ממפה לספרייה המכילה את הפריטים הבאים:

נושא/מְשׁוּתָף_*
קבצים לשים בספרייה המשותפת של גלריית האינטרנט, למשל CSS, Javascript, תמונות או
משאבים אחרים המשותפים לכל הגלריות.

נושא/browse.thtml
תבנית ה-XHTML עבור דף העיון בנושא הנושא (מציג תמונה אחת).

נושא/dirindex.thtml או נושא/dynindex.thtml
תבנית XHTML עבור דף אינדקס הספרייה (תמונות וקישורי תת-גלריות).

תלוי איזה קובץ אינדקס קיים, הנושא יהיה:

dirindex.thtml: סטטי לחלוטין
דף HTML אחד לכל תמונה, לכל גודל ואינדקס אחד לכל גודל, או

dynindex.thtml: דינמי
יש ליצור רק אינדקס אחד לכל ספרייה.

נושא/*.thtml חייב להיות XML חוקי. לִרְאוֹת
http://genshi.edgewall.org/wiki/Documentation/xml-templates.html עבור תחביר. תלות
עבור תבניות הכלולות באופן סטטי (כלומר עם שמות קבצים שאינם מחושבים ממשתנים) הם
מחושב אוטומטית: כאשר תבנית כלולה משתנה, התוכנה תעשה זאת
להבין אוטומטית אילו דפים ליצור מחדש. קבצי תבנית חסרים יהיו
חיפשו ב ברירת מחדל נושא.

נושאקבצי /SHARED_* (משאבים משותפים עבור הספרייה המשותפת) משתנים כדי להסיר את
משותף_ קידומת ו:

· מעובד באמצעות מנוע תבנית הטקסט Genshi (ראה
http://genshi.edgewall.org/wiki/Documentation/text-templates.html עבור תחביר.) אם
סיומת הקובץ שלהם מתחילה עם t,

· הועתק אל יעד אלבום האינטרנט אחרת.

שימוש במניפסט הנושא נושאקובץ /manifest.json, אפשר לכלול קבצים מ
ספריות אחרות שיועתקו לקבצים המשותפים של אלבום האינטרנט.

דוגמה 4. גלובלי

{
"משותף": [
# העתק כ-shared/lib.js
{ "path": "../lib-2.1.js", "dest": "lib.js" },

# העתק כ-shared/js/lib-2.1.js
{ "path": "../lib-2.1.js", "dest": "js/" }
]
}

אנא עיין בדוגמאות המסופקות ב-/usr/share/lazygal/themes.

אלבום מטא נתונים

אם ספרייה מאלבום המקור מכילה קובץ בשם album_description, הוא כן
מעובד כמקור למטא נתונים של אלבום. הפורמט מושאל מאלבום אחר
כלי יצירת - Matew. כל שורה מטופלת כאל תג אפשרי אחד, שורות לא ידועות כן
פשוט התעלמו. להלן תוכן לדוגמה של קובץ זה:

דוגמה 5. album_description

שם האלבום "האלבום שלי"
תיאור האלבום "תיאור, שיכול להיות ארוך מאוד."
מזהה תמונת אלבום relative/path/to/image.jpg

אחרת, המשתמש יכול לספק מטא נתונים בקבצים הבאים.

SOURCE_DIR/שם אלבום
הכותרת לשימוש עבור ספריית האלבום הזו.

SOURCE_DIR/אלבום-תיאור
התיאור עבור ספריית האלבום הזו. תגי HTML משמשים מילולית מקובץ זה.

SOURCE_DIR/אלבום-תמונה
התמונה לשימוש בחלק העליון של ערימת תמונות האלבום.

SOURCE_DIR/PICTURE_FILENAME.תגובה
התיאור לשימוש עבור התמונה הספציפית הזו. שים לב שתגי HTML נלקחים
כפי שסופק בקובץ זה לפלט בתבניות.

Lazygal גם מחלץ מידע מתגי מטא נתונים רבים בקבצי תמונה. לגבי תדמית
תיאור, Lazygal מחפש הערות בסדר הזה:

1. pic.jpegקובץ .comment

2. Exif.Photo.UserComment

3. Exif.Image.ImageDescription

4. Iptc.Application2.ObjectName

5. הערת JPEG

השתמש ב-lazygal באינטרנט באמצעות שירותי onworks.net