Untuk membaca kandungan fail Markdown tempatan dalam Pintasan Mac, tukarkan input fail kepada teks sebelum menggunakannya. Semak hasilnya dengan sampel sementara; jika penukaran gagal, baca fail dengan cat dan salurkan kandungannya ke dalam pintasan.

Panduan ini adalah untuk memilih satu fail Markdown tempatan dalam Finder dan memaparkan teks sumber literalnya, termasuk penanda tajuk dan tanda baca senarai. Perbezaan penting ialah antara tiga perkara: fail yang dipilih, laluan failnya dan teks yang tersimpan di dalamnya.

Mengapa pintasan menerima fail dan bukannya teksnya?

Finder memberikan input fail. Apple mentakrifkan Files dan Text sebagai jenis input Pintasan yang berasingan: fail boleh berupa dokumen dalam apa jua bentuk, manakala teks ialah teks biasa tanpa pemformatan. Oleh itu, menerima fail Markdown tidak bermakna tindakan seterusnya menerima kandungannya sebagai teks. Memahami jenis input dalam Pintasan pada Mac.

Pintasan menggunakan Content Graph untuk menukar antara jenis apabila tindakan memerlukannya. Apple juga mendokumenkan kawalan yang jelas: klik token pemboleh ubah dan tukar Type-nya. Penukaran itu berbeza daripada memilih sifat seperti nama fail. Nama atau laluan fail masih sekadar keterangan tentang fail tersebut. Enjin Content Graph, Laraskan pemboleh ubah dalam Pintasan pada Mac.

Panduan Apple yang dirujuk menerangkan mekanisme penukaran tetapi tidak menjamin bahawa setiap fail dengan sambungan .md akan ditukar kepada teks sumbernya. Anggap penukaran sebagai sesuatu yang perlu disahkan dengan kandungan yang diketahui. Kaedah berasaskan arahan di bawah menyediakan cara membaca fail secara jelas jika penukaran natif tidak menghasilkan teks yang dijangka.

Cipta fail Markdown sementara dengan kandungan yang diketahui

Gunakan fail contoh sintetik ini supaya nama fail tidak disalah anggap sebagai bukti bahawa pembacaan berjaya. Tampal keseluruhan persediaan ke dalam Terminal. Ia mencipta direktori sementara baharu, menulis satu fail contoh dan membuka direktori itu dalam Finder.

demo_dir=$(/usr/bin/mktemp -d /tmp/markdown-shortcuts.XXXXXX) &&
printf '%s\n' '# Sample board' '' '- Blue square' '- Green circle' > "$demo_dir/sample.md" &&
/usr/bin/open "$demo_dir"

Kandungan fail yang dijangka ialah:

# Sample board

- Blue square
- Green circle

Pilihan -d memberitahu mktemp supaya mencipta direktori, manakala aksara X di hujung membolehkannya memilih nama yang unik. Oleh itu, setiap persediaan yang berjaya mendapat direktori baharu. Jika penciptaan gagal, rantaian && menghalang arahan seterusnya daripada dijalankan. Apple mengedarkan manual mktemp yang berkaitan.

Arahan printf menulis baris sintetik, termasuk baris kosong. Pengalihan outputnya mencipta sample.md di dalam direktori baharu. Pengalihan > biasa boleh menulis ganti fail sedia ada, jadi kekalkan persediaan ini seperti adanya dan jangan ubah destinasinya kepada dokumen sedia ada. Direktori baharu itu mengelakkan pertembungan nama bagi contoh ini. Manual printf Apple, Input dan Output Shell.

Bina pintasan Finder yang meminta teks secara jelas

Cipta pintasan bernama Read Markdown Text. Apple mendokumenkan cara mencipta pintasan dengan butang tambah pada bar alat, menamakannya dan menambah tindakan daripada pustaka tindakan. Cipta pintasan tersuai pada Mac.

Sediakan titik masuk Finder-nya:

  1. Buka panel Details pintasan.
  2. Dayakan Use as Quick Action dan pilih Finder.
  3. Dalam blok input di bahagian atas editor, benarkan Files dan Text. Fail menyokong aliran kerja Finder; teks menyokong kaedah sandaran Terminal di bawah.
  4. Untuk input yang tiada, pilih Stop and Respond dan masukkan Select one example Markdown file.

Apple mendokumenkan pilihan Finder dan menyatakan bahawa input fail atau folder mungkin diperlukan untuk mendayakannya. Konfigurasi inputnya juga menyokong tindakan berhenti dengan respons apabila tiada input diterima. Jalankan pintasan semasa bekerja pada Mac, Hadkan input untuk pintasan.

Sekarang tambahkan tindakan pemprosesan kandungan:

  1. Tambahkan tindakan Text.
  2. Letakkan hanya pemboleh ubah Shortcut Input dalam medan teksnya.
  3. Klik token pemboleh ubah itu, buka menu Type-nya dan pilih Text. Elakkan daripada memilih sifat nama fail.
  4. Tambahkan Quick Look selepas tindakan Text dan gunakan output tindakan Text itu.

Penukaran pemboleh ubah yang jelas meminta teks pada titik input digunakan. Output tindakan Text yang berikutnya ialah nilai yang perlu digunakan dalam langkah pemprosesan teks seterusnya. Apple mendokumenkan cara menukar jenis pemboleh ubah melalui editor pemboleh ubah. Laraskan pemboleh ubah dalam Pintasan pada Mac.

Untuk mengesahkan pada versi yang dipasang, Control-klik ikon tindakan dan pilih Show Info. Apple mendokumenkan cara ini untuk memeriksa input yang diterima dan output yang terhasil daripada sesuatu tindakan. Ini amat berguna apabila mengubah suai pintasan sedia ada yang mengandungi beberapa pemboleh ubah fail dan teks. Navigasi senarai tindakan dalam Pintasan pada Mac.

Dalam Finder, pilih hanya sample.md, Control-kliknya dan pilih Quick Actions, kemudian Read Markdown Text. Apple mendokumenkan kaedah menjalankan pintasan ini. Jika pintasan tiada, semak dahulu tetapan Finder dan jenis input yang diterima. Jalankan pintasan semasa bekerja pada Mac.

Hasil yang berjaya mengandungi # Sample board dan kedua-dua item senarai. Melihat hanya sample.md atau laluan direktorinya tidak memenuhi semakan ini. Apple mengesyorkan supaya Quick Look diletakkan antara tindakan untuk memeriksa kandungan yang mengalir melalui pintasan. Menguji tindakan anda dalam Pintasan pada Mac.

Jika penukaran gagal, baca kandungan sebelum memanggil Pintasan

Gunakan Terminal untuk menjadikan operasi pembacaan itu jelas. Panduan Terminal Apple mengenal pasti cat sebagai alat untuk melihat kandungan fail teks. Panduan baris arahan Pintasan Apple membezakan input fail yang diberikan dengan -i daripada teks yang diberikan melalui paip. Lihat fail teks dalam Terminal pada Mac, Jalankan pintasan daripada baris arahan.

Arahan berikut ialah sambungan kepada contoh persediaan, bukan program yang berasingan. Jalankannya dalam tab Terminal yang sama selepas persediaan berjaya, dengan pintasan disimpan menggunakan nama tepat Read Markdown Text:

(
    set -o pipefail

    if [ -f "$demo_dir/sample.md" ] && [ -r "$demo_dir/sample.md" ]; then
        /bin/cat "$demo_dir/sample.md" |
            /usr/bin/shortcuts run "Read Markdown Text"
    else
        printf '%s\n' 'The example file is missing or unreadable.' >&2
        exit 1
    fi
)

Di sini, cat membaca fail dan menulis kandungannya ke output standard. Paip menghantar kandungan itu kepada pintasan. Meletakkan laluan dalam tanda petikan memastikan seluruhnya kekal sebagai satu argumen. Semakan -f dan -r memerlukan fail biasa yang wujud dan boleh dibaca. Asas Baris Perintah, Manual test Apple.

Tanda kurung mengehadkan perubahan pilihan shell kepada kumpulan arahan ini. pipefail menjadikan kegagalan mana-mana peringkat paip kelihatan dalam status keluar kumpulan itu. Semakan awal tidak menjamin bahawa fail kekal tersedia sepanjang pembacaan seterusnya; jika cat mengalami ralat pembacaan, periksa ralat itu dan jangan anggap pratonton separa sebagai lengkap.

Kaedah sandaran ini menukar kandungan masuk pintasan daripada fail kepada teks. Kaedah ini tidak menamakan semula fail Markdown atau mencipta dokumen yang ditukar. Tindakan Text dan Quick Look sedia ada boleh memeriksa teks masuk itu.

Tiga bentuk arahan ini membawa maksud yang berbeza:

Bentuk arahan Perkara yang diterima oleh pintasan
shortcuts run \"Read Markdown Text\" -i \"$demo_dir/sample.md\" Input fail; penukaran masih diperlukan dalam pintasan.
printf '%s\n' "$demo_dir/sample.md" | shortcuts run "Read Markdown Text" Laluan fail sebagai teks.
`cat "$demo_dir/sample.md" \ shortcuts run "Read Markdown Text"`

Jadual ini menggambarkan perbezaan yang didokumenkan oleh Apple antara menghantar laluan fail dengan -i dan menghantar teks melalui paip. Operasi sebelum paip menentukan sama ada teks itu ialah laluan fail atau isi dokumen. Jalankan pintasan daripada baris arahan.

Diagnosis hasil sebelum menambah lebih banyak tindakan

Gunakan fail contoh yang diketahui untuk menentukan perkara yang perlu dibaiki:

  • Hanya nama fail muncul: Semak sama ada pemboleh ubah mengekstrak sifat nama dan bukannya meminta teks.
  • Hanya laluan fail muncul: Semak sama ada arahan memaparkan laluan dan bukannya membaca fail.
  • Penukaran natif gagal tetapi kaedah Terminal berjaya: Gunakan kaedah pembacaan yang jelas untuk aliran kerja ini; menukar label input sahaja tidak menyelesaikan masalah penukaran.
  • Tiada input diterima: Jalankan pintasan daripada fail Finder yang dipilih atau dengan arahan Terminal yang didokumenkan. Melancarkan pintasan daripada Dock tidak membekalkan fail yang dipilih secara automatik.
  • Sumbernya kosong: Bandingkan dengan fail contoh. Fail kosong yang sah dan fail yang tiada ialah keadaan yang berbeza.

Apple mendokumenkan sifat pemboleh ubah secara berasingan daripada penukaran jenis kandungan dan menyatakan bahawa pintasan yang dilancarkan daripada Dock mungkin tidak menerima input awal. Perbezaan ini membantu mengenal pasti punca kegagalan sebelum mengubah tindakan seterusnya. Laraskan pemboleh ubah dalam Pintasan pada Mac, Hadkan input untuk pintasan.

Hadkan aliran kerja kepada satu fail teks tempatan yang kecil semasa menguji. Pemilihan berbilang fail memerlukan keputusan berasingan sama ada untuk memproses setiap fail atau menggabungkan kandungannya. Contoh ini memastikan teks sumber boleh dibaca; ini bukan prosedur menyalin fail bait demi bait.

Setelah pratonton mengandungi tajuk dan baris senarai yang dijangka, sambungkan tindakan pemprosesan teks seterusnya kepada output tindakan Text. Kekalkan fail contoh sintetik sehingga seluruh aliran itu berfungsi, kemudian padam direktorinya yang sementara dalam Finder. Semakan pentingnya mudah: tindakan seterusnya mesti menerima isi dokumen yang telah anda sahkan.

Sumber