במאמר הבא אנו נסתכל על פורמיקו. זהו עורך קטן שנבנה עם Python שמצאתי במקרה ב- GitHub. פורמיקו הוא יישום ReStructuredText עם עורך MarkDown ותצוגה מקדימה כדי לבדוק את התקדמות העבודה שנעשתה.
ReStructuredText הוא חלק מפרויקט Docutils ומשמש מתכנתי Python ליצירת תיעוד טכני. אני בטוח שיהיו הרבה אנשים שמעולם לא שמעו על ReStructuredText, אך באמצעות תוכנית זו וכמה מושגים בסיסיים תראו שקל להשתמש במערכת התחביר הזו. התוכנית נכתבת בפייתון עם Gtk3, GtkSourceView ו- Webkit2. השתמש ב- Docutils ו- סימן נפוץ משותף מחדש.
יש לומר זאת Markdown ול- ReStructuredText יכולות דומות. כהבדל, יש לציין כי ReStructuredText נועד ליצור תיעוד, הוא תומך בטבלאות והערות שוליים והערות סיום.
ReStructuredText היא מערכת מנתח ותחביר קלה לקריאה. זה שימושי לתיעוד תוכניות מקוון, מחרוזות מסמכי פייתון, ליצירה מהירה של דפי אינטרנט פשוטים ולמסמכים עצמאיים. המנתח reStructuredText הוא מרכיב של Docutils ומהווה עדכון ופירוש מחדש של מערכות הסימון הקלות של StructuredText ו- Setext.
מאפיינים כלליים של פורמיקו
פורמיקו
על פי עמוד GitHub של הפרויקט, פורמיקו כוללת את התכונות הבאות:
- הצגתי עורך בהתבסס על GtkSourceView עם הדגשת תחביר ועורך Vim.
- אנחנו הולכים חלק את אזור העבודה אנכית או אופקית.
- מציע א מצב תצוגה מקדימה לראות איך העבודה.
- JSON ותצוגה מקדימה של HTML.
- בדיקת איות.
זה גם תואם ל:
- מנתח מחדש של Docutils reStructuredText. Docutils HTML4, S5 / HTML slideshow ו- WBS HTML Writer.
- מנתח סימן נפוץ.
- כותב HTML זעיר.
- כותב HTML 5
התקנת פורמיקו באובונטו
למאמר זה אעשה זאת התקן את Formiko ב- Ubuntu 18.04. אנו נמצא תוכנית זו זמינה עבור דביאן ו- BSD כפי שאנו רואים בה דף GitHub.
פורמיקו וים
Requisitos
לפני שתמשיך בהתקנה, יש לומר שעל פי עמוד GitHub שלהם, אנחנו נצטרך לתקן כמה דרישות שמבקש מהתוכנית לתפקד כראוי כשאנחנו מתקינים אותה עם pip3.
- פיתון 2.7 או 3
- GTK+3
- גובייקט-התבוננות פנימית
- PyGObject
- ערכת רשת
- GtkSourceView
אנו פותחים מסוף (Ctrl + Alt + T) וכותבים:
sudo apt install python3-pip python3-gi python3-docutils gir1.2-gtksource-3.0 \ gir1.2-webkit2-4.0 gir1.2-gtkspell3-3.0
אני רוצה להבהיר שוב שאני מבצע התקנה זו באובונטו 18.04. לאחר מילוי הדרישות, נראה זאת התקנת התוכנית תתבצע דרך pip או apt כפי שאנחנו מעוניינים. ל השתמש ב- pip3 בהתקנה נכתוב במסוף (Ctrl + Alt + T):
pip3 install formiko
למקרה שאתה מעדיף השתמש ב- apt, באותו מסוף אנו כותבים:
sudo apt update && sudo apt install formiko
יש לומר ששני ההתקנות יספקו לנו את אותה גרסה של התוכנית. באופן אופציונלי אנו יכולים גם להתקין:
sudo apt install vim-gtk3 pip3 install docutils-tinyhtmlwriter recommonmark docutils-html5-writer
כאשר אנו מתקינים אותו, שני ערכים יתווספו לתפריט היישום: פורמיקו y פורמיקו וים.
נצטרך למצוא את המתאים ביותר לצרכינו.
הסר את התקנת פורמיקו
כפי שראינו שתי אפשרויות התקנה, נראה גם שתי פקודות להסרת התוכנית ממערכת ההפעלה שלנו.
הראשונה בפקודות תהיה זו המתייחסת ל ההתקנה נעשתה עם pip3. כדי לחסל את התוכנית אנו הולכים לפתוח מסוף (Ctrl + Alt + T) ולכתוב בו:
sudo pip3 uninstall formiko
כעת נראה את הפקודה למי שבחר ב התקנה עם apt. במסוף (Ctrl + Alt + T) אנו כותבים:
sudo apt purge formiko && sudo apt autoremove
זה אולי לא הכי טוב בתוכניות לתפקוד שלה, אבל אני חייב לומר שפורמיקו עבד בלי שום בעיה בזמן שבדקתי את זה. אני לא רוצה לסיים בלי לדבר קודם על מה שהיא אולי הנקודה השחורה הגדולה ביותר בתוכנית זו, ה- מגבלת פורמט איתו מאפשר לנו לעבוד
מידע נוסף אודות תוכנית זו ניתן לקבל בעמוד של פרויקט GitHub.