Linear
איך ייצוא Linear עובד, מהחיבור ועד פתרון בעיות.
חיבור
לחצו על “חיבור” ליד Linear תחת “ענן” במסך הבית של Exporter. התחברו עם Apple; הדפדפן פותח את הדף של Linear, שבו לוחצים על “Authorize”. Exporter מבקש מ-Linear לקרוא בלבד. בחזרה ב-Exporter, בחרו לאן הקבצים הולכים ולחצו על “שימוש בתיקייה הזו”.
האסימון של Linear נשאר חתום בשרת של Exporter. ה-Mac שלכם מתחבר לשרת הזה ולעולם לא מחזיק אותו.
בחירת פריטים
דף הבחירה מציג כל משימה, פרויקט ומסמך, כולם מסומנים, בשלוש כרטיסיות: משימות, פרויקטים ו-מסמכים. בטלו את הסימון ממה שלא תרצו; הקובץ שלו נשאר בחוץ.
לאן הקבצים הולכים
תיקייה שנמצאת ישירות בתיקיית הבית, כמו ~/Documents, מקבלת בתוכה תיקייה linear-export; תיקייה עמוקה יותר משמשת כמו שהיא.
- משימות: תיקייה לכל צוות, קובץ לכל משימה, בשם המזהה והכותרת שלה:
Northwind/NW-142 Invite flow.md - פרויקטים:
Projects/Q4 launch.md - מסמכים:
Documents/<project or team>/<title>.md
הקובץ
ה-front matter של משימה נושא id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due והתאריכים, עם source_url שפותח אותה ב-Linear. אחר כך הכותרת, התיאור וכל תגובה, מהישנה ביותר. פרויקט נושא את המצב, המוביל, הצוותים והתאריכים; מסמך את הפרויקט, הצוות ומי שיצר אותו. השעות לפי UTC.
סנכרון
Linear מודיע לשרת של Exporter על כל שינוי. השרת כותב את הקובץ מחדש מיד ומודיע ל-Mac, שמוריד אותו: שינוי מגיע תוך שניות, לכל היותר דקה. משימה ששמה שונה מעבירה את הקובץ; משימה שאתם מעבירים לארכיון, זורקים או מוחקים מאבדת אותו. “סנכרון עכשיו” שואל קודם את השרת; “סנכרון מלא מחדש” כותב כל קובץ מחדש.
Exporter Cloud
7 הימים הראשונים מהחיבור הראשון בחינם. אחר כך Exporter Cloud הוא מינוי ב-App Store: Linear לבד, או All Cloud לכל מקור ענן שנוסיף, חודשי או שנתי. כשתוכנית מסתיימת, הסנכרון נעצר והקבצים שלכם נשארים. שלושים יום אחר כך השרת מוחק את העותקים שלו ואת האסימון.
חשבון
הגדרות › חשבון מציג את כתובת הדוא״ל שאיתה התחברתם. “התנתקות” שומר את החיבור לפעם הבאה. “מחיקת החשבון…” מנתק כל סביבת עבודה ומוחק את כל מה שהשרת מחזיק עבורכם. הקבצים ב-Mac שלכם נשארים.
שורת פקודה
exporter export --source linear --dest <folder> כותב את הקבצים של סביבת העבודה לתיקייה שהותרה בכרטיס שורת הפקודה. ראו שורת הפקודה.
בעיות ותיקונים
- הכרטיס מציג “חיבור מחדש…”: Linear כבר לא מקבל את החיבור, לרוב כי האפליקציה הוסרה בהגדרות של Linear. לחצו עליו ואשרו שוב.
- הכרטיס מציג “התחברות…”: ההפעלה הסתיימה. התחברו עם אותו חשבון Apple והסנכרון ממשיך.
- חסרה משימה: בדקו שהיא מסומנת, ואז לחצו על “סנכרון עכשיו”. משימות בארכיון לא מיוצאות.