Obsidian CLI הוא ממשק שורת פקודה שמאפשר לשלוט ב-Obsidian מהטרמינל לצורך סקריפטים, אוטומציה ואינטגרציה עם כלים חיצוניים. כל מה שאפשר לעשות ב-Obsidian אפשר לעשות משורת הפקודה. Obsidian CLI אף כולל [[#פקודות למפתחים|פקודות למפתחים]] לגישה לכלי פיתוח, בדיקת אלמנטים, צילומי מסך, טעינה מחדש של תוספים ועוד. ![[obsidian-cli.mp4#interface]] > [!warning] דורש תוכנית התקנה של Obsidian 1.12 > שימוש ב-CLI דורש את תוכנית ההתקנה של Obsidian 1.12. ראו [[עדכון Obsidian#עדכוני תוכנית התקנה|מדריך עדכון גרסת תוכנית ההתקנה]]. ## התקנת Obsidian CLI שדרגו לגרסה האחרונה של [[עדכון Obsidian|תוכנית ההתקנה של Obsidian]] (1.12.7+). הפעילו את Obsidian CLI ב-Obsidian: 1. עברו אל **הגדרות** → **כללי**. 2. הפעילו **ממשק שורת פקודה**. 3. עקבו אחר ההנחיות לרישום Obsidian CLI. אם נתקלתם בבעיות בהתקנת Obsidian CLI ראו [[#פתרון בעיות]]. ## תחילת עבודה Obsidian CLI תומך הן בפקודות בודדות והן בממשק משתמש טרמינלי (TUI) עם עזרה אינטראקטיבית והשלמה אוטומטית. > [!info] אפליקציית Obsidian חייבת לפעול > Obsidian CLI דורש שאפליקציית Obsidian תפעל. אם Obsidian לא פועל, הפקודה הראשונה שתריצו תפעיל את Obsidian. > > מחפשים לסנכרן ללא אפליקציית שולחן העבודה? ראו [[סנכרון ללא ממשק|Obsidian Headless]]. ### הרצת פקודה הריצו פקודה בודדת מבלי לפתוח את ה-TUI: ```shell # הרצת פקודת עזרה obsidian help ``` ### שימוש בממשק הטרמינל השתמשו ב-TUI על ידי הקלדת `obsidian`. פקודות עוקבות ניתן להזין ללא `obsidian`. ```shell # פתיחת ה-TUI, ואז הרצת עזרה obsidian help ``` ה-TUI תומך בהשלמה אוטומטית, היסטוריית פקודות וחיפוש הפוך. השתמשו ב-`Ctrl+R` לחיפוש בהיסטוריית הפקודות. ראו [[#קיצורי מקלדת]] לכל הקיצורים הזמינים. ## דוגמאות הנה כמה דוגמאות למה ש-Obsidian CLI יכול לעשות. ### שימוש יומיומי ```shell # פתיחת ההערה היומית של היום obsidian daily # הוספת משימה להערה היומית obsidian daily:append content="- [ ] לקנות מצרכים" # חיפוש בכספת obsidian search query="הערות פגישה" # קריאת הקובץ הפעיל obsidian read # רשימת כל המשימות מההערה היומית obsidian tasks daily # יצירת הערה חדשה מתבנית obsidian create name="טיול לפריז" template=Travel # רשימת כל התגיות בכספת עם ספירות obsidian tags counts # השוואת שתי גרסאות של קובץ obsidian diff file=README from=1 to=3 ``` ### למפתחים [[#פקודות למפתחים|פקודות למפתחים]] רבות זמינות לפיתוח תוספים וערכות נושא. פקודות אלה מאפשרות לכלי קידוד אוטונומיים לבדוק ולנפות שגיאות באופן אוטומטי. ```shell # פתיחת כלי פיתוח obsidian devtools # טעינה מחדש של תוסף קהילתי שאתם מפתחים obsidian plugin:reload id=my-plugin # צילום מסך של האפליקציה obsidian dev:screenshot path=screenshot.png # הרצת JavaScript בקונסולת האפליקציה obsidian eval code="app.vault.getFiles().length" ``` ## כיצד לבצע ### שימוש בפרמטרים ודגלים פקודות יכולות להשתמש ב**פרמטרים** ו**דגלים**. רוב הפקודות לא דורשות פרמטרים או דגלים. פרמטרים נדרשים מסומנים כ-`required`. לדוגמה: ```shell # יצירת הערה חדשה עם שם ברירת המחדל "ללא כותרת" obsidian create ``` **פרמטר** מקבל ערך, נכתב כ-`parameter=value`. אם הערך מכיל רווחים, עטפו אותו במרכאות: ```shell # יצירת הערה חדשה בשם "Note" עם תוכן "Hello world" obsidian create name=Note content="Hello world" ``` **דגל** הוא מתג בוליאני ללא ערך. כללו אותו כדי להפעיל, לדוגמה `open` ו-`overwrite` הם דגלים: ```shell # יצירת הערה ופתיחתה obsidian create name=Note content="Hello" open overwrite ``` לתוכן רב-שורתי השתמשו ב-`\n` לשורה חדשה. השתמשו ב-`\t` לטאב. ```bash obsidian create name=Note content="# כותרת\n\nטקסט גוף" ``` ### מיקוד כספת אם ספריית העבודה הנוכחית של הטרמינל היא תיקיית כספת, אותה כספת תשמש כברירת מחדל. אחרת, הכספת הפעילה כרגע תשמש. השתמשו ב-`vault=<name>` או `vault=<id>` כדי למקד כספת ספציפית. זה חייב להיות הפרמטר הראשון לפני הפקודה: ```shell obsidian vault=Notes daily obsidian vault="My Vault" search query="test" ``` ב-TUI, השתמשו ב-`vault:open <name>` או `<id>` כדי לעבור לכספת אחרת. ### מיקוד קובץ פקודות רבות מקבלות פרמטרים `file` ו-`path` כדי למקד קובץ ספציפי. אם לא צוין אף אחד מהם, הפקודה ממוקדת כברירת מחדל לקובץ הפעיל. - `file=<name>` מפענח את הקובץ באמצעות אותו פענוח קישורים כמו [[קישורים פנימיים|קישורי ויקי]], התאמה לפי שם קובץ ללא צורך בנתיב המלא או בסיומת. - `path=<path>` דורש את הנתיב המדויק משורש הכספת, למשל `folder/note.md`. ```shell # אלה שקולים אם "Recipe.md" הוא הקובץ היחיד עם שם זה obsidian read file=Recipe obsidian read path="Templates/Recipe.md" ``` ### העתקת פלט הוסיפו `--copy` לכל פקודה כדי להעתיק את הפלט ללוח: ```shell read --copy search query="TODO" --copy ``` ## פקודות כלליות ### `help` הצגת רשימת כל הפקודות הזמינות. | פרמטר | תיאור | | ----------- | --------------------------------- | | `<command>` | הצגת עזרה לפקודה ספציפית. | ### `version` הצגת גרסת Obsidian. ### `reload` טעינה מחדש של חלון האפליקציה. ### `restart` הפעלה מחדש של האפליקציה. ## Bases פקודות עבור [[מבוא ל-Bases|Bases]]. ### `bases` רשימת כל קבצי `.base` בכספת. ### `base:views` רשימת תצוגות בקובץ ה-base הנוכחי. ### `base:create` יצירת פריט חדש ב-base. כברירת מחדל ממוקד לתצוגת ה-base הפעילה אם לא צוין קובץ. ```bash file=<name> # שם קובץ base path=<path> # נתיב קובץ base view=<name> # שם תצוגה name=<name> # שם קובץ חדש content=<text> # תוכן ראשוני open # פתח קובץ לאחר יצירה newtab # פתח בלשונית חדשה ``` ### `base:query` שאילתת base והחזרת תוצאות. ```bash file=<name> # שם קובץ base path=<path> # נתיב קובץ base view=<name> # שם תצוגה לשאילתה format=json|csv|tsv|md|paths # פורמט פלט (ברירת מחדל: json) ``` ## סימניות פקודות עבור [[סימניות]]. ### `bookmarks` רשימת סימניות. ```bash total # החזרת מספר סימניות verbose # כולל סוגי סימניות format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `bookmark` הוספת סימנייה. ```bash file=<path> # קובץ להוספת סימנייה subpath=<subpath> # נתיב משנה (כותרת או בלוק) בתוך קובץ folder=<path> # תיקייה להוספת סימנייה search=<query> # שאילתת חיפוש להוספת סימנייה url=<url> # כתובת URL להוספת סימנייה title=<title> # כותרת סימנייה ``` ## לוח פקודות פקודות עבור [[לוח פקודות]] ו[[מקשי קיצור]]. זה כולל את כל הפקודות הרשומות על ידי תוספים. ### `commands` רשימת מזהי פקודות זמינים. ```bash filter=<prefix> # סינון לפי קידומת מזהה ``` ### `command` ביצוע פקודת Obsidian. ```bash id=<command-id> # (חובה) מזהה פקודה לביצוע ``` ### `hotkeys` רשימת מקשי קיצור לכל הפקודות. ```bash total # החזרת מספר מקשי קיצור verbose # הצגה אם מקש הקיצור מותאם אישית format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `hotkey` קבלת מקש קיצור לפקודה. ```bash id=<command-id> # (חובה) מזהה פקודה verbose # הצגה אם מותאם אישית או ברירת מחדל ``` ## הערות יומיות פקודות עבור [[הערות יומיות]]. ### `daily` פתיחת הערה יומית. ```bash paneType=tab|split|window # סוג חלונית לפתיחה ``` ### `daily:path` קבלת נתיב הערה יומית. מחזיר את הנתיב הצפוי גם אם הקובץ עדיין לא נוצר. ### `daily:read` קריאת תוכן הערה יומית. ### `daily:append` הוספת תוכן לסוף ההערה היומית. ```bash content=<text> # (חובה) תוכן להוספה paneType=tab|split|window # סוג חלונית לפתיחה inline # הוספה ללא שורה חדשה open # פתח קובץ לאחר הוספה ``` ### `daily:prepend` הוספת תוכן לתחילת ההערה היומית. ```bash content=<text> # (חובה) תוכן להוספה paneType=tab|split|window # סוג חלונית לפתיחה inline # הוספה ללא שורה חדשה open # פתח קובץ לאחר הוספה ``` ## היסטוריית קבצים ### `diff` רשימה או השוואת גרסאות מ[[שחזור קובץ]] מקומי ו[[מבוא ל-Obsidian Sync|Sync]]. הגרסאות ממוספרות מהחדשה ביותר לישנה ביותר. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ from=<n> # מספר גרסה להשוואה ממנה to=<n> # מספר גרסה להשוואה אליה filter=local|sync # סינון לפי מקור גרסה ``` **דוגמאות:** ```shell # רשימת כל הגרסאות של הקובץ הפעיל diff # רשימת כל הגרסאות של קובץ ספציפי diff file=Recipe # השוואת הגרסה האחרונה לקובץ הנוכחי diff file=Recipe from=1 # השוואת שתי גרסאות diff file=Recipe from=2 to=1 # הצגת גרסאות Sync בלבד diff filter=sync ``` ### `history` רשימת גרסאות מ[[שחזור קובץ]] בלבד. ראו [[#Sync|sync:history]] לפקודת Sync המקבילה. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `history:list` רשימת כל הקבצים עם היסטוריה מקומית. ### `history:read` קריאת גרסת היסטוריה מקומית. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ version=<n> # מספר גרסה (ברירת מחדל: 1) ``` ### `history:restore` שחזור גרסת היסטוריה מקומית. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ version=<n> # (חובה) מספר גרסה ``` ### `history:open` פתיחת שחזור קבצים. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ## קבצים ותיקיות ### `file` הצגת מידע על קובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` דוגמה: ``` path Notes/Recipe.md name Recipe extension md size 1024 created 1700000000000 modified 1700001000000 ``` ### `files` רשימת קבצים בכספת. ```bash folder=<path> # סינון לפי תיקייה ext=<extension> # סינון לפי סיומת total # החזרת מספר קבצים ``` ### `folder` הצגת מידע על תיקייה. ```bash path=<path> # (חובה) נתיב תיקייה info=files|folders|size # החזרת מידע ספציפי בלבד ``` ### `folders` רשימת תיקיות בכספת. ```bash folder=<path> # סינון לפי תיקיית אב total # החזרת מספר תיקיות ``` ### `open` פתיחת קובץ. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ newtab # פתח בלשונית חדשה ``` ### `create` יצירה או דריסה של קובץ. ```bash name=<name> # שם קובץ path=<path> # נתיב קובץ content=<text> # תוכן ראשוני template=<name> # תבנית לשימוש overwrite # דרוס אם הקובץ קיים open # פתח קובץ לאחר יצירה newtab # פתח בלשונית חדשה ``` ### `read` קריאת תוכן קובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `append` הוספת תוכן לסוף קובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ content=<text> # (חובה) תוכן להוספה inline # הוספה ללא שורה חדשה ``` ### `prepend` הוספת תוכן לתחילת קובץ אחרי המטא-נתונים (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ content=<text> # (חובה) תוכן להוספה inline # הוספה ללא שורה חדשה ``` ### `move` העברה או שינוי שם של קובץ (ברירת מחדל: קובץ פעיל). פעולה זו תעדכן אוטומטית [[קישורים פנימיים]] אם מופעל ב[[הגדרות#עדכן תמיד קישורים פנימיים|הגדרות הכספת]]. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ to=<path> # (חובה) תיקיית יעד או נתיב ``` ### `rename` שינוי שם קובץ (ברירת מחדל: קובץ פעיל). סיומת הקובץ נשמרת אוטומטית אם הושמטה מהשם החדש. השתמשו ב-[[#`move`|move]] לשינוי שם והעברת קובץ בו-זמנית. פעולה זו תעדכן אוטומטית [[קישורים פנימיים]] אם מופעל ב[[הגדרות#עדכן תמיד קישורים פנימיים|הגדרות הכספת]]. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ name=<name> # (חובה) שם קובץ חדש ``` ### `delete` מחיקת קובץ (ברירת מחדל: קובץ פעיל, לאשפה כברירת מחדל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ permanent # דלג על אשפה, מחק לצמיתות ``` ## קישורים פקודות עבור [[קישורים נכנסים]] ו[[קישורים יוצאים]]. ### `backlinks` רשימת קישורים נכנסים לקובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ יעד path=<path> # נתיב קובץ יעד counts # כולל ספירת קישורים total # החזרת מספר קישורים נכנסים format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `links` רשימת קישורים יוצאים מקובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ total # החזרת מספר קישורים ``` ### `unresolved` רשימת קישורים לא מפוענחים בכספת. ```bash total # החזרת מספר קישורים לא מפוענחים counts # כולל ספירת קישורים verbose # כולל קבצי מקור format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `orphans` רשימת קבצים ללא קישורים נכנסים. ```bash total # החזרת מספר יתומים ``` ### `deadends` רשימת קבצים ללא קישורים יוצאים. ```bash total # החזרת מספר מבוי סתום ``` ## מתאר פקודות עבור [[מתווה]]. ### `outline` הצגת כותרות לקובץ הנוכחי. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ format=tree|md|json # פורמט פלט (ברירת מחדל: tree) total # החזרת מספר כותרות ``` ## תוספים פקודות עבור [[תוספי ליבה]] ו[[תוספים קהילתיים]]. ### `plugins` רשימת תוספים מותקנים. ```bash filter=core|community # סינון לפי סוג תוסף versions # כולל מספרי גרסה format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `plugins:enabled` רשימת תוספים מופעלים. ```bash filter=core|community # סינון לפי סוג תוסף versions # כולל מספרי גרסה format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) ``` ### `plugins:restrict` הפעלה/כיבוי או בדיקת מצב מוגבל. ```bash on # הפעל מצב מוגבל off # השבת מצב מוגבל ``` ### `plugin` קבלת מידע על תוסף. ```bash id=<plugin-id> # (חובה) מזהה תוסף ``` ### `plugin:enable` הפעלת תוסף. ```bash id=<id> # (חובה) מזהה תוסף filter=core|community # סוג תוסף ``` ### `plugin:disable` השבתת תוסף. ```bash id=<id> # (חובה) מזהה תוסף filter=core|community # סוג תוסף ``` ### `plugin:install` התקנת תוסף קהילתי. ```bash id=<id> # (חובה) מזהה תוסף enable # הפעל לאחר התקנה ``` ### `plugin:uninstall` הסרת תוסף קהילתי. ```bash id=<id> # (חובה) מזהה תוסף ``` ### `plugin:reload` טעינה מחדש של תוסף (למפתחים). ```bash id=<id> # (חובה) מזהה תוסף ``` ## מאפיינים פקודות הקשורות ל[[מאפיינים]]. ### `aliases` רשימת כינויים בכספת. השתמשו ב-`active` או `file`/`path` להצגת כינויים לקובץ ספציפי. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ total # החזרת מספר כינויים verbose # כולל נתיבי קבצים active # הצג כינויים לקובץ הפעיל ``` ### `properties` רשימת מאפיינים בכספת. השתמשו ב-`active` או `file`/`path` להצגת מאפיינים לקובץ ספציפי. ```bash file=<name> # הצג מאפיינים לקובץ path=<path> # הצג מאפיינים לנתיב name=<name> # קבל ספירת מאפיין ספציפי sort=count # מיון לפי ספירה (ברירת מחדל: שם) format=yaml|json|tsv # פורמט פלט (ברירת מחדל: yaml) total # החזרת מספר מאפיינים counts # כולל ספירת הופעות active # הצג מאפיינים לקובץ הפעיל ``` ### `property:set` הגדרת מאפיין על קובץ (ברירת מחדל: קובץ פעיל). ```bash name=<name> # (חובה) שם מאפיין value=<value> # (חובה) ערך מאפיין type=text|list|number|checkbox|date|datetime # סוג מאפיין file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `property:remove` הסרת מאפיין מקובץ (ברירת מחדל: קובץ פעיל). ```bash name=<name> # (חובה) שם מאפיין file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `property:read` קריאת ערך מאפיין מקובץ (ברירת מחדל: קובץ פעיל). ```bash name=<name> # (חובה) שם מאפיין file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ## Publish פקודות עבור [[מבוא ל-Obsidian Publish|Obsidian Publish]]. ### `publish:site` הצגת מידע על אתר Publish (slug, כתובת URL). ### `publish:list` רשימת קבצים שפורסמו. ```bash total # החזרת מספר קבצים שפורסמו ``` ### `publish:status` רשימת שינויי פרסום. ```bash total # החזרת מספר שינויים new # הצג קבצים חדשים בלבד changed # הצג קבצים ששונו בלבד deleted # הצג קבצים שנמחקו בלבד ``` ### `publish:add` פרסום קובץ או כל הקבצים ששונו (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ changed # פרסם את כל הקבצים ששונו ``` ### `publish:remove` ביטול פרסום קובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `publish:open` פתיחת קובץ באתר המפורסם (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ## הערות אקראיות פקודות עבור [[הערה אקראית]]. ### `random` פתיחת הערה אקראית. ```bash folder=<path> # הגבל לתיקייה newtab # פתח בלשונית חדשה ``` ### `random:read` קריאת הערה אקראית (כולל נתיב). ```bash folder=<path> # הגבל לתיקייה ``` ## חיפוש פקודות עבור [[חיפוש]]. ### `search` חיפוש טקסט בכספת. מחזיר נתיבי קבצים תואמים. ```bash query=<text> # (חובה) שאילתת חיפוש path=<folder> # הגבל לתיקייה limit=<n> # מקסימום קבצים format=text|json # פורמט פלט (ברירת מחדל: text) total # החזרת מספר תוצאות case # רגיש לאותיות גדולות ``` ### `search:context` חיפוש עם הקשר שורות תואמות. מחזיר פלט בסגנון grep `path:line: text`. ```bash query=<text> # (חובה) שאילתת חיפוש path=<folder> # הגבל לתיקייה limit=<n> # מקסימום קבצים format=text|json # פורמט פלט (ברירת מחדל: text) case # רגיש לאותיות גדולות ``` ### `search:open` פתיחת תצוגת חיפוש. ```bash query=<text> # שאילתת חיפוש ראשונית ``` ## Sync פקודות עבור [[מבוא ל-Obsidian Sync|Obsidian Sync]]. > [!tip] סנכרון ללא אפליקציית שולחן העבודה > פקודות אלה שולטות ב-Sync בתוך אפליקציית Obsidian הפועלת. לסנכרון כספות משורת הפקודה ללא אפליקציית שולחן העבודה, ראו [[סנכרון ללא ממשק]]. ### `sync` השהיה או חידוש סנכרון. ```bash on # חדש סנכרון off # השהה סנכרון ``` ### `sync:status` הצגת סטטוס סנכרון ושימוש. ### `sync:history` רשימת היסטוריית גרסאות סנכרון לקובץ (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ total # החזרת מספר גרסאות ``` ### `sync:read` קריאת גרסת סנכרון (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ version=<n> # (חובה) מספר גרסה ``` ### `sync:restore` שחזור גרסת סנכרון (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ version=<n> # (חובה) מספר גרסה ``` ### `sync:open` פתיחת היסטוריית סנכרון (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ ``` ### `sync:deleted` רשימת קבצים שנמחקו בסנכרון. ```bash total # החזרת מספר קבצים שנמחקו ``` ## תגיות פקודות עבור [[תגים]]. ### `tags` רשימת תגיות בכספת. השתמשו ב-`active` או `file`/`path` להצגת תגיות לקובץ ספציפי. ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ sort=count # מיון לפי ספירה (ברירת מחדל: שם) total # החזרת מספר תגיות counts # כולל ספירת תגיות format=json|tsv|csv # פורמט פלט (ברירת מחדל: tsv) active # הצג תגיות לקובץ הפעיל ``` ### `tag` קבלת מידע על תגית. ```bash name=<tag> # (חובה) שם תגית total # החזרת מספר הופעות verbose # כולל רשימת קבצים וספירה ``` ## משימות פקודות לניהול משימות. ### `tasks` רשימת משימות בכספת. השתמשו ב-`active` או `file`/`path` להצגת משימות לקובץ ספציפי. ```bash file=<name> # סינון לפי שם קובץ path=<path> # סינון לפי נתיב קובץ status="<char>" # סינון לפי תו סטטוס total # החזרת מספר משימות done # הצג משימות שהושלמו todo # הצג משימות שלא הושלמו verbose # קיבוץ לפי קובץ עם מספרי שורות format=json|tsv|csv # פורמט פלט (ברירת מחדל: text) active # הצג משימות לקובץ הפעיל daily # הצג משימות מההערה היומית ``` **דוגמאות:** ```bash # רשימת כל המשימות בכספת tasks # רשימת משימות שלא הושלמו בכספת tasks todo # רשימת משימות שהושלמו מקובץ ספציפי tasks file=Recipe done # רשימת משימות מההערה היומית של היום tasks daily # ספירת משימות בהערה היומית tasks daily total # רשימת משימות עם נתיבי קבצים ומספרי שורות tasks verbose # סינון לפי סטטוס מותאם אישית (ציטוט תווים מיוחדים) tasks 'status=?' ``` ### `task` הצגה או עדכון משימה. ```bash ref=<path:line> # הפניית משימה (path:line) file=<name> # שם קובץ path=<path> # נתיב קובץ line=<n> # מספר שורה status="<char>" # הגדרת תו סטטוס toggle # הפעלת/כיבוי סטטוס משימה daily # הערה יומית done # סמן כהושלם todo # סמן כלא הושלם ``` **דוגמאות:** ```bash # הצגת מידע על משימה task file=Recipe line=8 task ref="Recipe.md:8" # הפעלת/כיבוי השלמת משימה task ref="Recipe.md:8" toggle # הפעלת/כיבוי משימה בהערה היומית task daily line=3 toggle # הגדרת סטטוס משימה task file=Recipe line=8 done # → [x] task file=Recipe line=8 todo # → [ ] task file=Recipe line=8 status=- # → [-] task daily line=3 done # סמן משימה בהערה היומית כהושלמה ``` ## תבניות פקודות עבור [[תבניות]]. ### `templates` רשימת תבניות. ```bash total # החזרת מספר תבניות ``` ### `template:read` קריאת תוכן תבנית. ```bash name=<template> # (חובה) שם תבנית title=<title> # כותרת לפענוח משתנים resolve # פענח משתני תבנית ``` ### `template:insert` הכנסת תבנית לקובץ הפעיל. ```bash name=<template> # (חובה) שם תבנית ``` **הערות:** - אפשרות `resolve` מעבדת משתנים `{{date}}`, `{{time}}`, `{{title}}` - השתמשו ב-`create path=<path> template=<name>` ליצירת קובץ עם תבנית ## ערכות נושא וקטעים פקודות עבור [[ערכות נושא]] ו[[קטעי CSS]]. ### `themes` רשימת ערכות נושא מותקנות. ```bash versions # כולל מספרי גרסה ``` ### `theme` הצגת ערכת נושא פעילה או קבלת מידע. ```bash name=<name> # שם ערכת נושא לפרטים ``` ### `theme:set` הגדרת ערכת נושא פעילה. ```bash name=<name> # (חובה) שם ערכת נושא (ריק עבור ברירת מחדל) ``` ### `theme:install` התקנת ערכת נושא קהילתית. ```bash name=<name> # (חובה) שם ערכת נושא enable # הפעל לאחר התקנה ``` ### `theme:uninstall` הסרת ערכת נושא. ```bash name=<name> # (חובה) שם ערכת נושא ``` ### `snippets` רשימת קטעי CSS מותקנים. ### `snippets:enabled` רשימת קטעי CSS מופעלים. ### `snippet:enable` הפעלת קטע CSS. ```bash name=<name> # (חובה) שם קטע ``` ### `snippet:disable` השבתת קטע CSS. ```bash name=<name> # (חובה) שם קטע ``` ## הערות ייחודיות פקודות עבור [[יוצר פתק ייחודי]]. ### `unique` יצירת הערה ייחודית. ```bash name=<text> # שם הערה content=<text> # תוכן ראשוני paneType=tab|split|window # סוג חלונית לפתיחה open # פתח קובץ לאחר יצירה ``` ## כספת ### `vault` הצגת מידע על כספת. ```bash info=name|path|files|folders|size # החזרת מידע ספציפי בלבד ``` ### `vaults` רשימת כספות ידועות. ```bash total # החזרת מספר כספות verbose # כולל נתיבי כספות ``` ### `vault:open` מעבר לכספת אחרת (TUI בלבד). ```bash name=<name> # (חובה) שם כספת ``` ## מציג אינטרנט פקודות עבור [[מציג אינטרנט]]. ### `web` פתיחת כתובת URL במציג אינטרנט. ```bash url=<url> # (חובה) כתובת URL לפתיחה newtab # פתח בלשונית חדשה ``` ## ספירת מילים פקודות עבור [[ספירת מילים]]. ### `wordcount` ספירת מילים ותווים (ברירת מחדל: קובץ פעיל). ```bash file=<name> # שם קובץ path=<path> # נתיב קובץ words # החזרת ספירת מילים בלבד characters # החזרת ספירת תווים בלבד ``` ## מרחב עבודה פקודות עבור [[חלל עבודה]] ותוסף [[חללי עבודה]]. ### `workspace` הצגת עץ מרחב עבודה. ```bash ids # כולל מזהי פריטי מרחב עבודה ``` ### `workspaces` רשימת מרחבי עבודה שמורים. ```bash total # החזרת מספר מרחבי עבודה ``` ### `workspace:save` שמירת הפריסה הנוכחית כמרחב עבודה. ```bash name=<name> # שם מרחב עבודה ``` ### `workspace:load` טעינת מרחב עבודה שמור. ```bash name=<name> # (חובה) שם מרחב עבודה ``` ### `workspace:delete` מחיקת מרחב עבודה שמור. ```bash name=<name> # (חובה) שם מרחב עבודה ``` ### `tabs` רשימת לשוניות פתוחות. ```bash ids # כולל מזהי לשוניות ``` ### `tab:open` פתיחת לשונית חדשה. ```bash group=<id> # מזהה קבוצת לשוניות file=<path> # קובץ לפתיחה view=<type> # סוג תצוגה לפתיחה ``` ### `recents` רשימת קבצים שנפתחו לאחרונה. ```bash total # החזרת מספר קבצים אחרונים ``` ## פקודות למפתחים פקודות שעוזרות לפתח [[תוספים קהילתיים]] ו[[ערכות נושא]]. למידע נוסף עברו אל [תיעוד המפתחים של Obsidian](https://docs.obsidian.md). ### `devtools` הפעלה/כיבוי כלי פיתוח Electron. ### `dev:debug` חיבור/ניתוק דיבאגר Chrome DevTools Protocol. ```bash on # חבר דיבאגר off # נתק דיבאגר ``` ### `dev:cdp` הרצת פקודת Chrome DevTools Protocol. ```bash method=<CDP.method> # (חובה) שיטת CDP להפעלה params=<json> # פרמטרי שיטה כ-JSON ``` ### `dev:errors` הצגת שגיאות JavaScript שנלכדו. ```bash clear # נקה את מאגר השגיאות ``` ### `dev:screenshot` צילום מסך (מחזיר PNG ב-base64). ```bash path=<filename> # נתיב קובץ פלט ``` ### `dev:console` הצגת הודעות קונסול שנלכדו. ```bash limit=<n> # מקסימום הודעות להצגה (ברירת מחדל 50) level=log|warn|error|info|debug # סינון לפי רמת לוג clear # נקה את מאגר הקונסול ``` ### `dev:css` בדיקת CSS עם מיקומי מקור. ```bash selector=<css> # (חובה) סלקטור CSS prop=<name> # סינון לפי שם מאפיין ``` ### `dev:dom` שאילתת אלמנטי DOM. ```bash selector=<css> # (חובה) סלקטור CSS attr=<name> # קבלת ערך תכונה css=<prop> # קבלת ערך מאפיין CSS total # החזרת מספר אלמנטים text # החזרת תוכן טקסט inner # החזרת innerHTML במקום outerHTML all # החזרת כל ההתאמות במקום הראשונה ``` ### `dev:mobile` הפעלה/כיבוי אמולציית מובייל. ```bash on # הפעל אמולציית מובייל off # השבת אמולציית מובייל ``` ### `eval` הרצת JavaScript והחזרת תוצאה. ```bash code=<javascript> # (חובה) קוד JavaScript להרצה ``` ## קיצורי מקלדת קיצורים אלה זמינים ב[[#שימוש בממשק הטרמינל|TUI]]. ### ניווט | פעולה | קיצור | | ---------------------------------------------------- | -------------- | | הזז סמן שמאלה | `←` / `Ctrl+B` | | הזז סמן ימינה (מקבל הצעה בסוף שורה) | `→` / `Ctrl+F` | | קפוץ לתחילת שורה | `Ctrl+A` | | קפוץ לסוף שורה | `Ctrl+E` | | הזז מילה אחת אחורה | `Alt+B` | | הזז מילה אחת קדימה | `Alt+F` | ### עריכה | פעולה | קיצור | | ------------------------- | -------------------------- | | מחק עד תחילת שורה | `Ctrl+U` | | מחק עד סוף שורה | `Ctrl+K` | | מחק מילה קודמת | `Ctrl+W` / `Alt+Backspace` | ### השלמה אוטומטית | פעולה | קיצור | | ------------------------------------------------ | ----------- | | כניסה למצב הצעות / קבלת הצעה נבחרת | `Tab` | | יציאה ממצב הצעות | `Shift+Tab` | | כניסה למצב הצעות (מקלט חדש) | `↓` | | קבלת הצעה ראשונה/נבחרת (בסוף שורה) | `→` | ### היסטוריה | פעולה | קיצור | | -------------------------------------------------------- | -------------- | | ערך היסטוריה קודם / ניווט הצעות למעלה | `↑` / `Ctrl+P` | | ערך היסטוריה הבא / ניווט הצעות למטה | `↓` / `Ctrl+N` | | חיפוש הפוך בהיסטוריה (הקלידו לסינון, `Ctrl+R` למחזור) | `Ctrl+R` | ### אחר | פעולה | קיצור | | -------------------------------------------------- | ------------------- | | ביצוע פקודה או קבלת הצעה | `Enter` | | בטל השלמה אוטומטית / צא ממצב הצעות / נקה קלט | `Escape` | | נקה מסך | `Ctrl+L` | | יציאה | `Ctrl+C` / `Ctrl+D` | ## פתרון בעיות אם אתם נתקלים בבעיות בהרצת Obsidian CLI: - ודאו שאתם משתמשים בגרסה האחרונה של [[עדכון Obsidian|תוכנית ההתקנה של Obsidian]] (1.12.7 או מעלה). - אם זה עתה עדכנתם את Obsidian מגרסה מוקדמת יותר, כבו את הגדרת ה-CLI והפעילו אותה מחדש, ואז אפשרו ל-Obsidian לבצע את רישום ה-PATH האוטומטי. - הפעילו מחדש את הטרמינל לאחר רישום ה-CLI כדי ששינויי ה-PATH ייכנסו לתוקף. - Obsidian חייב לפעול. ה-CLI מתחבר למופע Obsidian הפועל. ### Windows Obsidian CLI ב-Windows דורש תוכנית התקנה של Obsidian 1.12.7+. ראו [[עדכון Obsidian|עדכון גרסת תוכנית ההתקנה]]. Windows משתמש במפנה טרמינל שמחבר את Obsidian ל-stdin/stdout כראוי. זה הכרחי מכיוון ש-Obsidian בדרך כלל פועל כאפליקציית GUI שאינה תואמת לפלטי טרמינל ב-Windows. כאשר אתם מתקינים Obsidian 1.12.7+ מפנה הטרמינל `Obsidian.com` יתווסף לתיקייה בה התקנתם את קובץ `Obsidian.exe`. רישום ה-CLI מוסיף את Obsidian למשתנה PATH של המשתמש שלכם, מה שנכנס לתוקף רק לאחר הפעלה מחדש של הטרמינל. ### macOS רישום ה-CLI יוצר קישור סמלי ב-`/usr/local/bin/obsidian` שמצביע לבינארי ה-CLI המצורף בתוך האפליקציה. פעולה זו דורשת הרשאות מנהל — תוצג לכם בקשה באמצעות דו-שיח מערכתי. בדקו שהקישור הסמלי קיים ומצביע לבינארי הנכון: ``` ls -l /usr/local/bin/obsidian ``` אם הקישור הסמלי חסר, צרו אותו ידנית: ``` sudo ln -sf /Applications/Obsidian.app/Contents/MacOS/obsidian-cli /usr/local/bin/obsidian ``` > [!note] אם רשמתם את ה-CLI בעבר עם גרסה ישנה יותר של Obsidian, ייתכן שנשאר ערך PATH ב-`~/.zprofile`. תהליך הרישום החדש מסיר זאת אוטומטית, אך אם הוא נשאר, תוכלו למחוק בביטחון את השורות שמתחילות ב-`# Added by Obsidian` מ-`~/.zprofile`. ### Linux רישום ה-CLI מעתיק את בינארי ה-CLI ל-`~/.local/bin/obsidian`. פעולה זו נעשית מכיוון שחלק משיטות ההתקנה ב-Linux פועלות מספריות זמניות שלא ניתן ליצור אליהן קישורים סמליים באופן קבוע. ודאו ש-`~/.local/bin` נמצא ב-PATH שלכם. הוסיפו את הדברים הבאים ל-`~/.bashrc` או `~/.zshrc` אם הוא לא שם: ``` export PATH="$PATH:$HOME/.local/bin" ``` בדקו שהבינארי קיים: ``` ls -l ~/.local/bin/obsidian ``` אם הבינארי חסר, העתיקו אותו ידנית מספריית ההתקנה של Obsidian: ``` cp /path/to/Obsidian/obsidian-cli ~/.local/bin/obsidian chmod 755 ~/.local/bin/obsidian ```