Tufte-css: Penurunan harga untuk ini?

Pandoc menawarkan template untuk dibangun, jadi membuat template pandoc Tufte harus mudah.

@langford ternyata sudah ada templat Tufte untuk Pandoc, lihat komentar saya di sini untuk detail tentang mengubah Penurunan Harga/Multi-Penurunan Harga menjadi gaya Tufte: https://github.com/daveliepmann/tufte-css/issues/30#issuecomment - 128718117

@xHN35RQ setelah melihat ke dalamnya sedikit, pandoc template sepertinya jalan yang salah untuk fungsi ini: template diberikan $body$ string dan cukup banyak berharap untuk hanya menempatkan teks sebelum dan sesudahnya, dan tampaknya tidak dimaksudkan untuk benar-benar memanipulasi teks yang dihasilkan dari penurunan harga. Anda akan menggunakan penulis kustom pandoc yang dapat Anda tulis (haleluya) di Lua. Saya telah menulis penulis kustom barebone yang hanya mengimplementasikan sidenotes dan menambahkan tag article : lihat Gist . Saya berharap untuk memperluas ini saat saya terus menulis tufte-css untuk memasukkan semua fitur yang disediakan — idealnya tanpa harus mengubah apa pun tentang penurunan harga pandoc atau pembacanya.

(Untuk kelengkapan, saya mungkin menyebutkan filter pandoc sebagai sesuatu yang pada akhirnya mungkin diperlukan untuk sepenuhnya menghasilkan HTML yang mendukung tufte-css dari penurunan harga pandoc, tetapi mungkin hanya untuk hal-hal yang sangat rumit. Filter memanipulasi AST, sebelum AST diberikan kepada penulis khusus . Tempat yang tepat untuk membuat sidenote gaya tufte-css adalah di custom writer, bukan sebagai filter.)

@fasiha kerja bagus. Anda telah membuat awal yang menjanjikan di sini. :+1:

Saya tidak berpikir ada padanan yang tersedia untuk tufte-css _sections_ di Penurunan harga, yaitu, pengelompokan paragraf dan judul. Tapi saya pikir saya menyukai ide bagian, saya pikir memiliki tingkat organisasi dokumen ekstra akan membantu di jalan.

Adakah saran dari komunitas bagaimana cara menunjukkan bagian dalam Penurunan Harga?

@fasiha Bagaimana dengan filter yang mengambil elemen heading dan semua elemen paragraf ke elemen heading berikutnya? Kemudian bungkus ini dengan tag <section> (atau <div> ) khusus dan terapkan css yang diinginkan untuk ini?

Terima kasih telah menimbang @vyp. Dari pembacaan saya di halaman depan tufte-css, section dapat menangkap lebih dari satu heading, atau paragraf tanpa heading. Artinya, ini bukan hanya wadah heading-and-contents. Dalam dokumen saya, saya hanya menyematkan <section> sebagai HTML mentah di Markdown untuk saat ini—untuk ini, saya pikir saya dapat menerima HTML mentah.

@fasiha Ah maaf anda benar. Karena bagian didefinisikan sebagai "pengelompokan teks dan judul yang logis", tidak mungkin untuk menentukan apa sebenarnya bagian dalam dokumen tanpa masukan manusia (yaitu kami benar-benar menandai bagian sebagai informasi semantik, seperti cara kami menandai dengan penekanan dengan tanda bintang atau garis bawah). Dan ya, saya tidak mengetahui sintaks yang sudah ada sebelumnya untuk "bagian" ini dalam rasa penurunan harga apa pun, jadi tangkapan yang bagus.

Menggunakan tag <section> mentah adalah hal terbaik yang mungkin dilakukan dalam kasus ini (selain mendefinisikan sintaks mirip penurunan harga Anda sendiri untuknya dan menulis parser untuknya).

Cara lain untuk pergi adalah dengan menggunakan fakta bahwa tufte mengatakan menggunakan h2 untuk "judul bagian", jadi mungkin "bagian" dapat didefinisikan sebagai tag h2 dan semuanya hingga tag h2 berikutnya dan seterusnya. Tapi saya tidak yakin apakah ini yang dimaksudkan oleh penulis tufte.

Elemen H2 bukanlah sumber demarkasi bagian yang dapat diandalkan. Misalnya, beberapa dokumen menggunakan rentang "pemikiran baru". Saya yakin variasi lain akan muncul di alam liar.

Pada 8 Au 2015, pukul 23:49, vyp [email protected] menulis:

@fasiha Ah maaf anda benar. Karena bagian didefinisikan sebagai "pengelompokan teks dan judul yang logis", tidak mungkin untuk menentukan apa sebenarnya bagian dalam dokumen tanpa masukan manusia (yaitu kami benar-benar menandai bagian sebagai informasi semantik, seperti cara kami menandai dengan penekanan dengan tanda bintang atau garis bawah). Dan ya, saya tidak mengetahui sintaks yang sudah ada sebelumnya untuk "bagian" ini dalam rasa penurunan harga apa pun, jadi tangkapan yang bagus.

Menggunakan mentah

tag adalah hal terbaik yang mungkin dilakukan dalam kasus ini (selain mendefinisikan sintaks seperti penurunan harga Anda sendiri untuknya dan menulis parser untuknya).

Cara lain untuk pergi adalah dengan menggunakan fakta bahwa tufte mengatakan menggunakan h2 untuk "judul bagian", jadi mungkin "bagian" dapat didefinisikan sebagai tag h2 dan semuanya hingga tag h2 berikutnya dan seterusnya. Tapi saya tidak yakin apakah ini yang dimaksudkan oleh penulis tufte.

—
Balas email ini secara langsung atau lihat di GitHub.

Saya kira jika ada yang ingin menghindari penggunaan tag <section> dalam penurunan harga mereka, beberapa sintaks yang mirip dengan <hr> mungkin tidak sulit untuk diterapkan. Sintaks untuk <hr> 's pada dasarnya adalah "tiga atau lebih tanda hubung, tanda bintang, atau garis bawah pada satu baris sendiri". Jadi misalnya Anda dapat secara sewenang-wenang mendefinisikan demarkasi "bagian" sebagai "tiga atau lebih tanda sama dengan" (atau apa pun yang Anda suka), dan kemudian menggunakan filter pandoc untuk membungkus semuanya di antara setiap pasangan paragraf ini dengan hanya tanda sama dengan.

Saya hanya memilih "garis tanda sama dengan" karena saya rasa seperti inikah pembagian bagian dengan teks biasa _look_? Dan karena penurunan harga pandoc akan menguraikan ini hanya sebagai paragraf, artinya filter Anda hanya dapat memeriksa setiap paragraf apakah hanya memiliki tanda sama dengan atau tidak, dan jika hanya terdiri dari tanda sama dengan, anggap ini adalah bagian dari demarkasi bagian.

Hai semua (dan terima kasih kepada @daveliepmann karena telah mengarahkan saya ke utas ini). Anda mungkin tertarik dengan paket glasseye saya di mana saya telah menggunakan Tufte.css (jadi terima kasih kepada semua orang untuk itu) dan di mana saya bertujuan untuk mengintegrasikan penurunan harga, d3 dan tata letak Tufte. Saat ini sangat banyak prototipe dengan banyak pemotongan sudut. Ketika saya punya waktu, saya ingin membersihkan kode dan sedikit merasionalisasi desain (pada saat itu saya akan menelusuri komentar Anda tentang css). Tetapi saya ingin melihat apakah itu layak dilakukan terlebih dahulu dan saya pikir itu layak. Pokoknya akan menyukai umpan balik.

Apakah reStructuredText lebih dapat diterima daripada Penurunan harga untuk jenis anotasi yang diperlukan di sini?

@coppeliaMLA Terima kasih telah menyebutkan glasseye, ini pekerjaan yang luar biasa.

@rbcarson Saya bukan OP, tetapi jika pertanyaannya ditujukan pada semua orang di sini dan Anda menginginkan pendapat saya, saya pribadi tidak begitu akrab dengan teks yang direstrukturisasi jadi saya tidak bisa mengatakannya. Tapi Anda mungkin benar, sintaks penurunan harga dasar yang dibuat oleh Gruber, Swartz dan rekannya, menurut saya, terinspirasi dari cara orang menulis (teks biasa) email 'saat itu'. Jadi itu hanya dimulai serumit (atau 'mampu') seperti yang bisa didapatkan oleh pesan email rata-rata, bukan makalah penelitian atau bentuk tulisan lain yang menggunakan banyak sidenote atau mengikuti atau masuk akal dengan gaya Tufte.

Jadi selama bertahun-tahun, hanya ada begitu banyak jenis sintaks lain yang dapat Anda masukkan ke dalam "penurunan harga" karena intinya adalah bahwa itu seharusnya dapat dibaca dalam bentuk teks biasa. Bagaimana Anda menyampaikan sidenote secara visual dalam teks biasa? Namun demikian, saya merasa penurunan harga pandoc yang diperpanjang telah melakukan pekerjaan yang sangat baik dalam hal ini.

Jadi saya pikir teks yang direstrukturisasi memiliki sesuatu yang disebut arahan atau sesuatu, yang memungkinkan Anda membuat sintaks (atau sesuatu?) untuk jenis data tertentu? Jika itu masalahnya, ya, saya pikir teks yang direstrukturisasi mungkin lebih dapat diterima di sini. Tapi seperti yang saya katakan, saya tidak punya banyak pengalaman dengan itu, jadi saya tidak bisa membantu Anda lebih jauh.

restructuredText tidak akan berguna untuk tujuan saya, yang merupakan proyek yang sudah didokumentasikan dalam penurunan harga

Pada 17 Agustus 2015, pukul 04:24, vyp [email protected] menulis:

@coppeliaMLA Terima kasih telah menyebutkan glasseye, ini pekerjaan yang luar biasa.

@rbcarson Saya bukan OP, tetapi jika pertanyaannya ditujukan pada semua orang di sini dan Anda menginginkan pendapat saya, saya pribadi tidak begitu akrab dengan teks yang direstrukturisasi jadi saya tidak bisa mengatakannya. Tapi Anda mungkin benar, sintaks penurunan harga dasar yang dibuat oleh Gruber, Swartz dan rekannya, menurut saya, terinspirasi dari cara orang menulis (teks biasa) email 'saat itu'. Jadi itu hanya dimulai serumit (atau 'mampu') seperti yang bisa didapatkan oleh pesan email rata-rata, bukan makalah penelitian atau bentuk tulisan lain yang menggunakan banyak sidenote atau mengikuti atau masuk akal dengan gaya Tufte.

Jadi selama bertahun-tahun, hanya ada begitu banyak jenis sintaks lain yang dapat Anda masukkan ke dalam "penurunan harga" karena intinya adalah bahwa itu seharusnya dapat dibaca dalam bentuk teks biasa. Bagaimana Anda menyampaikan sidenote secara visual dalam teks biasa? Namun demikian, saya merasa penurunan harga pandoc yang diperpanjang telah melakukan pekerjaan yang sangat baik dalam hal ini.

Jadi saya pikir teks yang direstrukturisasi memiliki sesuatu yang disebut arahan atau sesuatu, yang memungkinkan Anda membuat sintaks (atau sesuatu?) untuk jenis data tertentu? Jika itu masalahnya, ya, saya pikir teks yang direstrukturisasi mungkin lebih dapat diterima di sini. Tapi seperti yang saya katakan, saya tidak punya banyak pengalaman dengan itu, jadi saya tidak bisa membantu Anda lebih jauh.

—
Balas email ini secara langsung atau lihat di GitHub.

@coppeliaMLA sangat menarik!: gunakan pandoc untuk menampilkan HTML dengan tag khusus, dan kemudian sebagai tahap kedua, gunakan program lain untuk memperluas tag khusus ke Javascript dan HTML. Pendekatan saya adalah membuat penulis kustom Pandoc yang menggunakan tag khusus, secara efektif melakukan glasseye.py di Lua, menggunakan Pandoc AST alih-alih penguraian BeautifulSoup, tetapi sepertinya glasseye pada dasarnya berfungsi dengan baik. Saya akan mencoba untuk memeriksa dokumen saya dan memberi tahu Anda di reponya tentang masalah apa pun. Hal-hal yang sulit dilakukan di seorang penulis Pandoc mungkin lebih mudah dilakukan pasca-pemrosesan, dan sebaliknya, tetapi satu-satunya cara untuk mengetahuinya adalah dengan menulis banyak dokumen :)

@fasiha terima kasih. Cara Anda memang terdengar lebih efisien dan saya pikir mungkin saya akan menuju ke arah itu pada akhirnya. Saya menggunakan python karena memungkinkan saya membuat prototipe cepat. Tetapi seperti yang Anda katakan, bereksperimen pada banyak dokumen akan mengasah metode terbaik. Saya berencana menggunakannya untuk pekerjaan sehari-hari saya sebanyak mungkin untuk melihat di mana itu membawa saya. Akan sangat bagus jika Anda bisa mencobanya. Senang mendengar bagaimana kelanjutannya!

Lihat #31 dan juga #58

Untuk apa nilainya: Saya baru saja mengumpulkan tufte-pandoc-css untuk memecahkan masalah menulis catatan sampingan dalam penurunan harga. Ini hanya sebuah karya tentang cara menggunakan filter Pandoc khusus yang saya tulis bernama pandoc-sidenote .

Untuk melihatnya beraksi:

• Implementasi ulang tufte-css/index.html dalam penurunan harga rasa Pandoc
• Demo beberapa fitur Pandoc lainnya , seperti blok kode yang disorot sintaks.

@jez keren! Saya akan melihat apakah saya dapat menemukan proyek untuk memutar ini.

Baru saja menemukan utas ini melalui Google

Kalian mungkin ingin melihat xmark : yang mengubah penurunan harga menjadi Tufte-CSS melalui XSLT.

@vieiro wow ini bagus. Kerja bagus 👍🏻