Logseq-ის მომხმარებლებისთვის, რომლებიც ძველი Markdown ჩანაწერების ახალ სისტემაში გადატანას ცდილობენ, ახალი ინსტრუმენტი გამოჩნდა. Logseq Doctor სპეციალურად იმისთვის შეიქმნა, რომ ფაილების სტრუქტურა გაასწოროს და Logseq-ის მოთხოვნებს შეუსაბამოს.

პროექტი ამჟამად განვითარების ადრეულ, ალფა ეტაპზეა. ავტორები აფრთხილებენ მომხმარებლებს, რომ შესაძლოა შეხვდნენ ხარვეზებს როგორც დოკუმენტაციაში, ისე ფუნქციონალში. მიუხედავად ამისა, უტილიტა უკვე გვთავაზობს კონკრეტულ გადაწყვეტილებებს ფაილების მანიპულაციისთვის.

ტექნიკური მახასიათებლები და განვითარება

ამჟამად Logseq Doctor ხელმისაწვდომია ორი ვერსიით: Python-ისა და Go-ს ბრძანების ხაზის ინტერფეისებით (CLI). გრძელვადიანი გეგმა ითვალისწინებს Python-ის კომპონენტის სრულად ჩანაცვლებას Go-თი. ყველა ახალი ფუნქცია ამიერიდან მხოლოდ Go-ს ვერსიაში დაემატება.

ინსტალაციის გზები

მომხმარებლებს, რომლებიც macOS ან Linux ოპერაციულ სისტემებს იყენებენ, ინსტალაციისთვის Homebrew-ის გამოყენებას ურჩევენ. ალტერნატიულ შემთხვევაში, შესაძლებელია ხელით ინსტალაციაც. Python-ის მოყვარულთათვის რეკომენდებულია pipx-ის მეშვეობით გლობალური ინსტალაცია, რაც lqdpy ბრძანების გააქტიურებას უზრუნველყოფს.

როგორ დავიწყოთ მუშაობა

პროექტის წყარო კოდიდან აწყობის შემთხვევაში, შეგიძლიათ დამოუკიდებლად დააკომპილიროთ როგორც Go, ისე Python ვერსიები. მას შემდეგ, რაც ინსტალაციას დაასრულებთ, შეგიძლიათ გამოიყენოთ შემდეგი ბრძანებები:

  • lqd - Go-ს ვერსიის ბრძანებებისა და ოფციების სანახავად.
  • lqdpy - Python-ის ვერსიის მართვისთვის.

დეველოპერებისთვის გათვალისწინებულია ლოკალური გარემოს გამართვის ინსტრუქციებიც. პროექტის რეპოზიტორიაში ხელმისაწვდომია სპეციალური სკრიპტები, რომლებიც ტესტირების პროცესს აადვილებს და საშუალებას გაძლევთ, გააერთიანოთ მონაცემები სხვადასხვა გარემოდან (tox environments).

მიუხედავად იმისა, რომ ინსტრუმენტი ჯერ კიდევ „უხეშია“, მისი მთავარი დანიშნულებაა, გაამარტივოს ფაილების იმპორტი და თავიდან აგვაცილოს ხელით გასწორების რუტინული პროცესი.