يسمح لك Qnote بإنشاء عشرات الآلاف من الملاحظات القصيرة والبحث فيها بسرعة.
#
يتم تخزين الملاحظات في قاعدة بيانات SQLite (سيأتي الدعم لمزيد من قواعد البيانات). يتم توفير البحث بواسطة Bleve (افتراضي) أو Elasticsearch مع بعض الإعدادات الإضافية.
إذا لم تكن قد قمت بذلك بالفعل، فأنت بحاجة إلى إعداد Golang. من مجرد تشغيل
go get github.com/anmil/quicknote/cmd/qnote
سيؤدي هذا إلى سحب المكتبة وإدراجها في دليل Golang bin.
يتيح لك الكتاب الاحتفاظ بالملاحظات ذات الصلة منفصلة عن بعضها البعض، مثل ملاحظات العمل مقابل الملاحظات الشخصية. ما لم ينص على خلاف ذلك، يتم تنفيذ كل إجراء فقط على كتاب العمل. يمكنك تغيير كتاب العمل باستخدام العلامة -n
.
لإنشاء كتاب جديد
qnote new book <book name>
qnote ls books
يمكنك حذف الكتب وجميع الملاحظات الموجودة في الكتاب.
qnote rm book <book name>
إذا كنت تريد إزالة كتاب مع الاحتفاظ بالملاحظات. يمكنك دمج الكتاب في كتاب آخر. يقوم برنامج دمج الكتب بأخذ كافة الملاحظات من كتاب واحد ونقلها إلى كتاب آخر، ثم يقوم بحذف الكتاب الفارغ.
qnote merge <book to delete> <book to move notes to>
يمكن تقسيم الكتب بطريقتين، إما من نتائج الاستعلام أو من قائمة معرفات الملاحظات.
عن طريق الاستعلام
qnote split query <book name> <query>
سيؤدي هذا إلى إجراء بحث استعلام (باستخدام QueryStringQuery) في كتاب العمل وسيتم نقل نتائج الاستعلام إلى <book name>
(إنشاءه إذا لم يكن موجودًا). لا تحتاج إلى تحديد الكتاب في سلسلة الاستعلام. تمت إضافته بالفعل لك.
بواسطة معرفات
qnote split ids <book name> <note ids...>
يؤدي هذا الأمر بنفس الطريقة ولكن بدلاً من الاستعلام عن الملاحظات، فإنه ينقل الملاحظات للمعرفات المحددة.
لفتح المحرر (Vim الافتراضي، تجاوز باستخدام Env: EDITOR) وإنشاء ملاحظة جديدة
qnote new note
يتم تشغيل الملاحظات من خلال محلل يأخذ السطر الأول كعنوان والباقي كنص. يتم استخدام أي كلمة تبدأ بحرف #
كعلامة للملاحظة.
إنشاء ملاحظة مع النص التالي
This is a test #note
notes are #cool and #fun
one #note is never enough
سيتم إنشاء ملاحظة بعنوان This is a test #note
، وعلامات note, cool, fun
، ونص
notes are #cool and #fun
one #note is never enough
يمكنك أيضًا إنشاء ملاحظة من عنوان URL.
qnote new url <url>
سيقوم qnote بتنفيذ طلب GET على عنوان URL. سيقوم بتحليل HTML الذي تم إرجاعه title
صفحة الويب، meta[name=keywords]
، وعلامات meta[name=description]
. يتم استخدام العنوان بالإضافة إلى عنوان URL كعنوان، ويتم استخدام الكلمات الرئيسية للعلامات والوصف للنص الأساسي. سيتم فتح المحرر بهذه المعلومات المملوءة ويسمح لك بإجراء تغييرات قبل حفظها.
لسرد جميع الملاحظات في الكتاب
qnote ls notes
لسرد جميع الملاحظات في جميع الكتب
qnote ls notes all
لفتح المحرر وتحرير ملاحظة
qnote edit note <note id>
لحذف ملاحظة
qnote rm note `<note id>`
يستخدم qnote Bleve بشكل افتراضي، ولكنه يدعم أيضًا ElasticSearch لفهرسة الملاحظات والسماح بالبحث. يوصى باستخدام ElasticSearch إذا كنت لا تمانع في إجراء إعداد إضافي قليلًا لأنه أقوى بكثير وأسرع. إذا قمت بتثبيت Elasticsearch، فيمكنك تحرير ملف تكوين qnote الموجود في $HOME/.config/quicknote
على Linux و $HOME/Library/Application Support/quicknote
على Max OSX.
للبحث في ملاحظاتك في كتاب العمل باستخدام بادئة العبارة
qnote search query
يمكنك أيضًا استخدام صيغة الاستعلام الأكثر قوة QueryStringQuery (Bleve ElasticSearch) عن طريق تعيين العلامة -q
. لاحظ أنه عند استخدام العلامة -q
، يتم تشغيل الاستعلام على كافة الكتب.
الحقول التي يمكنك البحث فيها هي id
، created
، modifed
، title
، tags
(قائمة منفصلة مشتركة)، body
، book
. لذلك، إذا كنت تريد البحث عن أي ملاحظات في كتاب "العمل" الذي يحمل العلامة "projectx". سوف تركض
ل بليف
qnote search -q "+book:Work +tag:projectx"
والبحث المرن
qnote search -q "book:Work AND tags:projectx"
عندما تقوم بإنشاء الملاحظات وتحريرها وحذفها، سيهتم برنامج qnote بتحديث الفهرس. ولكن، إذا كنت بحاجة إلى إعادة الفهرسة لأسباب مثل تغيير موفري الفهرسة، أو إعادة تثبيت ElasticSearch، أو نسخ قاعدة بيانات الملاحظات من نظام آخر. يمكنك الركض
qnote search reindex
وسوف يقوم qnote بإعادة فهرسة جميع الملاحظات.
إن أبسط طريقة لعمل نسخة احتياطية من ملاحظاتك هي نسخ qnote.db في دليل البيانات $HOME/.config/quicknote
على Linux و $HOME/Library/Application Support/quicknote
على Max OSX. يمكنك أيضًا تصدير القائمة بتنسيق csv أو json باستخدام العلامة -f
في أمر qnote ls notes
.
حاليًا، لا توجد طريقة لاستعادة الملاحظات من ملف csv أو json.
جميع الأوامر والأعلام هي مستندات في أمر help
. قم بتشغيل qnote help <command>
لعرض الوصف والإشارات الخاصة بأي أمر
مثال 1:
$ qnote help
Qnote allows you to quickly create and search tens of thousands of short notes.
Create Books to organize collections of notes.
Add tags to notes for more accurate searching.
Export your notes in text, csv, and json.
Notes are stored in an SQLite database (support for more databases is coming).
Searching is provided by Bleve by default, or Elasticsearch with some extra setup.
Usage:
qnote [command]
Available Commands:
delete Delete Note or Notebook
edit Edit Note or Notebook
get Get/List Notes, Notebook, Tags
merge Merge all notes from <book_name 1> into <book_name 2>
new Create new Note or Notebook
search Search notes
split Split Book
version Print the version of qnote
Flags:
-n, --notebook string Working Notebook (default "General")
Use "qnote [command] --help" for more information about a command.
مثال 2:
$ qnote help edit book
Edit the working Book's name. This requires re-index the Book
Usage:
qnote edit book <new book_name> [flags]
Global Flags:
مثال 3:
$ qnote get -h
Get/List Notes, Notebook, Tags
Usage:
qnote get [command]
Aliases:
get, list, ls
Available Commands:
book List all books
note List all notes in the working Book, or all notes for the given [note id...]
tag lists all tags for the working Book
Flags:
-f, --display-format string Format to display notes in [ids, text, short, json, csv] (default "text")
-d, --display-order string The order to display Notebook, Notes, Tags [asc, desc] (default "asc")
-s, --sort-by string Sort notes by [id, created, modified, title] (default "modified")
Global Flags:
-n, --notebook string Working Notebook (default "General")
Use "qnote get [command] --help" for more information about a command.