Rajah rajah duyung dan carta aliran telah mendapat daya tarikan, terutamanya dengan pengumuman GitHub bahawa mereka disokong secara asli di Markdown. Mari kita lihat apa yang mereka ada, bagaimana menggunakannya, dan sama pentingnya: mengapa .
Sama seperti anda mungkin ingin membenamkan demo codepen anda secara langsung dalam sumber dokumentasi anda, mempunyai gambar rajah dan carta anda bersebelahan dengan teks anda membantu menghalang mereka daripada membusuk - iaitu, hanyut dari selaras dengan keadaan dokumen anda. Sama seperti komen yang tidak membantu, usang, atau sebaliknya mengelirukan dalam kod anda boleh menjadi objektif lebih buruk daripada tiada komen, perkara yang sama berlaku untuk gambar rajah.
Rajah duyung berpasangan dengan baik dengan jemak dan penjana tapak statik, yang terus berkembang popular. Pasangan itu semulajadi. Walaupun gambar rajah duyung tidak eksklusif markdown, mereka terinspirasi markdown. Menggunakan markdown abstractions markup yang sama menyediakan kod notat, duyung boleh diwakili sama dengan gambarajah output dan carta aliran. Dan Markdown adalah untuk jemak dan tapak statik sebagai mentega kacang adalah untuk jeli.
Jika laman web anda ditulis dalam markdown, diproses ke HTML, dan anda mempunyai kawalan yang cukup untuk menambah sedikit JavaScript tersuai, maka anda boleh menggunakan idea -idea yang kami tutupi dalam artikel ini agar sesuai dengan keperluan anda sendiri dan melaksanakan gambar rajah dengan duyung dengan mudah di samping markdown anda. Adakah "rajah-as-kod" istilah lagi? Ia sepatutnya.
Sebagai contoh, katakan bahawa anda sedang mengusahakan produk baru yang mewah dan anda ingin memberikan peta jalan dalam bentuk carta Gantt (atau beberapa jenis lain - katakan carta aliran, urutan, dan rajah kelas). Dengan Mermaid, anda boleh melakukan ini dalam beberapa baris kecil:
Gantt Tajuk Pelan Pelan Produk Saya dateformat yyyy-mm-dd Ciri -ciri sejuk bahagian Tugas: A1, 2022-02-25, 30D Tugas lain: selepas A1, 20D Ciri Rad Bahagian Tugas dalam urutan: 2022-03-04, 12D Tugas, No. 2: 24d
Yang akan menjadikan rajah SVG yang bagus seperti itu:
Petua Pro: Mermaid mempunyai editor langsung yang membolehkan anda mencubanya tanpa komitmen di Mermaid.Live.
Rajah Mermaid di Markdown
Mermaid berjalan lancar dengan Markdown kerana ia membentangkan dirinya sebagai satu lagi blok kod berpagar, hanya menggunakan set sintaks Bahasa Mermaid. Sebagai contoh, blok kod ini:
`` `Mermaid Graf TD; A-> B; A-> c; B-> D; C-> d; `` `
... Menghasilkan elemen HTML
<pre class="brush:php;toolbar:false"> <code> Graph TD; A-> B; A-> c; B-> D; C-> d; </code>
Jika anda menggunakan pemproses markdown yang sejajar dengan spec commonmark, ia akan lebih menyerupai ini:
<pre class="brush:php;toolbar:false"> <code> Graph TD; A-> B; A-> c; B-> D; C-> d; </code>Lihat demo
Tingkah laku lalai API Mermaid mengharapkan tag
atau <span> (seperti dari penyerlah sintaks) yang mungkin anda lihat dalam penukaran dari Markdown-to-HTML.<h3 id="Finessing-dengan-JavaScript"> Finessing dengan JavaScript</h3>
<p> Dengan sedikit JavaScript, adalah munasabah untuk mengambil HTML yang dihasilkan oleh Markdown dan menstabilkannya ke dalam tag </p>
<div> yang sasaran duyung. Perlu diingat bahawa $ elemen.TextContent adalah tujuan di sini: Markdown akan html-encode spesifik aksara (seperti> ke & gt;) yang digunakan duyung. Ia juga menapis sebarang elemen HTML yang salah yang merupakan keturunan elemen <ce>.<pre rel="JavaScript" data-line=""> // pilih <pre class="brush:php;toolbar:false"> _and_ <ce> <ode>
document.QuerySelectorAll ("pre.mermaid, pre> code.language-dermaid"). foreach ($ el => {
// Jika pemilih kedua mendapat hit, rujuk ibu bapa <pre class="brush:php;toolbar:false">
jika ($ el.tagname === "kod")
$ el = $ el.parentElement
// Letakkan kandungan duyung dalam jangkaan <div>
// Plus menyimpan kandungan asal dalam <pandasan> yang bagus
$ el.outerhtml = `
<div> $ {$ el.textcontent} </div>
<utiran>
<summary> Sumber Diagram </summary>
<pre class="brush:php;toolbar:false"> $ {$ el.textcontent} </pre>
`
})<p> Sekarang bahawa HTML kami diformat dengan betul, mari kita melaksanakan Mermaid untuk melakukan rendering.</p>
<h3 id="Menggunakan-duyung"> Menggunakan duyung</h3>
<p> Mermaid diterbitkan sebagai pakej NPM, jadi anda boleh mengambil salinan dengan menggunakan CDN yang menyedari pakej, seperti UNPKG. Anda akan mahu menggunakan kod minified (misalnya, duy.min.js) dan bukannya eksport lalai mermaid.core.js. Contohnya:</p>
<pre rel="HTML" data-line=""> <script src="https://unpkg.com/%5E%20dilindungi%5D%20/dist/mermaid.min.js"> </script></pre>
<p> Mermaid <em>juga</em> ESM-siap, jadi anda boleh menggunakan Skypack untuk memuatkannya juga:</p>
<pre rel="HTML" data-line=""> <script type="Module">
Import Mermaid dari "https://cdn.skypack.dev/^ dilindungi]";
</script></pre>
<p> Anda boleh berhenti di sini jika anda ingin menyimpan perkara yang mudah. Secara lalai, Mermaid akan auto-initialize sendiri apabila dokumen sudah siap. Selagi anda melakukan markdown-to-HTML yang menyempurnakan dengan JavaScript yang disebut sebelum ini- <em>sebelum</em> dimuatkan di Mermaid-anda akan ditetapkan.</p>
<p> Walau bagaimanapun, Mermaid mempunyai beberapa tetapan yang bernilai mengkonfigurasi:</p>
<pre rel="JavaScript" data-line=""> // Inisialisasi duyung ke [1] kesilapan log, [2] mempunyai keselamatan longgar untuk pihak pertama
// Gambar rajah yang ditulis, dan [3] menghormati skema warna gelap yang disukai
duys.initialize ({
Loglevel: "Ralat", // [1]
SecurityLevel: "longgar", // [2]
Tema: (window.matchmedia && window.matchmedia ("(lebih suka-warna-skema: gelap)"). Perlawanan)?
"Gelap":
"lalai" // [3]
})</pre>
<ol>
<li> Loglevel akan memberi anda lebih banyak penglihatan ke dalam sebarang kesilapan yang mungkin timbul. Jika anda ingin melihat lebih banyak maklumat, anda boleh memilih tahap yang lebih verbose (atau sebaliknya).</li>
<li> SecurityLevel berkaitan dengan tahap kepercayaan untuk sumber rajah. Jika kandungannya <em>anda</em> menulis, maka "longgar" baik -baik saja. Jika ia adalah kandungan yang dihasilkan oleh pengguna, ia mungkin lebih baik meninggalkan "ketat" lalai di tempatnya.</li>
<li> Tema mengubah gaya gambarajah yang diberikan. Dengan menanyakan skema warna pilihan dan memanfaatkan pengendali ternary, kami boleh menentukan "gelap" yang sesuai.</li>
</ol>
<h3 id="Semua-bersama-sekarang"> Semua bersama sekarang!</h3>
<p> Berikut adalah beberapa contoh rajah duyung dalam markdown:</p>
<h3 id="Perairan-yang-lebih-dalam"> Perairan yang lebih dalam</h3>
<p> Strategi ini sangat berkesan kerana ia <em>progresif</em> : jika JavaScript dilumpuhkan maka sumber duyung asal dipaparkan sebagai-is. Tiada busuk.</p>
<p> Terdapat juga antara muka baris arahan sepenuhnya untuk Mermaid yang, jika anda menarik dalam meneroka, berpotensi dapat dimanfaatkan untuk memaparkan gambar rajah yang benar-benar diberikan pelayan. Antara duyung CLI dan penjana dalam talian, mungkin juga mungkin untuk menyambungkan apa sahaja proses membina yang anda gunakan untuk menghasilkan gambaran gambarajah dan memaparkannya sebagai <mg> fallback dan bukannya kod sumber.</mg></p>
<p> Mudah -mudahan, kita akan melihat lebih banyak integrasi duyung asli seperti ini kerana Mermaid terus berkembang popular. Kegunaan mempunyai carta visual dan gambar rajah di samping dokumentasi tidak dapat dipertikaikan - dari jalan raya produk ke pokok keputusan dan segala -galanya di antara. Itulah jenis maklumat yang sukar untuk didokumentasikan dengan kata -kata sahaja.</p>
<p> Carta Mermaid menyelesaikannya, dan dengan cara yang memastikan maklumat dapat diuruskan dan dikekalkan bersama -sama dengan dokumentasi yang lain.</p></utiran></pandasan>
</div></pre></ode></ce></pre></pre></ce>
</div></span>
Atas ialah kandungan terperinci Membuat gambar rajah duyung di markdown. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Alat AI Hot

Undress AI Tool
Gambar buka pakaian secara percuma

Undresser.AI Undress
Apl berkuasa AI untuk mencipta foto bogel yang realistik

AI Clothes Remover
Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.

Clothoff.io
Penyingkiran pakaian AI

Video Face Swap
Tukar muka dalam mana-mana video dengan mudah menggunakan alat tukar muka AI percuma kami!

Artikel Panas

Alat panas

Notepad++7.3.1
Editor kod yang mudah digunakan dan percuma

SublimeText3 versi Cina
Versi Cina, sangat mudah digunakan

Hantar Studio 13.0.1
Persekitaran pembangunan bersepadu PHP yang berkuasa

Dreamweaver CS6
Alat pembangunan web visual

SublimeText3 versi Mac
Perisian penyuntingan kod peringkat Tuhan (SublimeText3)

Terdapat tiga cara untuk membuat pemutar pemuatan CSS: 1. Gunakan pemutar asas sempadan untuk mencapai animasi mudah melalui HTML dan CSS; 2. Gunakan pemutar tersuai pelbagai mata untuk mencapai kesan lompat melalui masa kelewatan yang berlainan; 3. Tambahkan pemutar dalam butang dan beralih kelas melalui JavaScript untuk memaparkan status pemuatan. Setiap pendekatan menekankan pentingnya butiran reka bentuk seperti warna, saiz, kebolehcapaian dan pengoptimuman prestasi untuk meningkatkan pengalaman pengguna.

Untuk menangani keserasian pelayar CSS dan isu awalan, anda perlu memahami perbezaan sokongan penyemak imbas dan menggunakan awalan vendor dengan munasabah. 1. Memahami masalah biasa seperti Flexbox dan sokongan grid, kedudukan: prestasi tidak sah, dan prestasi animasi adalah berbeza; 2. Periksa status sokongan ciri CANIUSE Ciri; 3. Gunakan dengan betul -webkit-, -moz-, -ms-, -o- dan awalan pengeluar lain; 4. Adalah disyorkan untuk menggunakan autoprefixer untuk menambah awalan secara automatik; 5. Pasang postcss dan konfigurasi penyemak imbas untuk menentukan penyemak imbas sasaran; 6. Secara automatik mengendalikan keserasian semasa pembinaan; 7. Ciri -ciri pengesanan moden boleh digunakan untuk projek lama; 8. Tidak perlu meneruskan konsistensi semua pelayar,

Themaindifferencesbetweendisplay: inline, block, andinline-blockinhtml/cssarelayoutbehavior, spaceusage, andstylingcontrol.1.inlineelementsflowwithtext, notstartonNewlines, abaikanwidth/height, andonyapplylylylylylinddding/

Menetapkan gaya pautan yang telah anda lawati dapat meningkatkan pengalaman pengguna, terutama di laman web yang berintensifkan kandungan untuk membantu pengguna menavigasi lebih baik. 1. Gunakan CSS: Kelas pseudo yang dilawati untuk menentukan gaya pautan yang dikunjungi, seperti perubahan warna; 2. Perhatikan bahawa penyemak imbas hanya membenarkan pengubahsuaian beberapa atribut disebabkan oleh sekatan privasi; 3. Pemilihan warna harus diselaraskan dengan gaya keseluruhan untuk mengelakkan ketangkasan; 4. Terminal mudah alih mungkin tidak memaparkan kesan ini, dan disyorkan untuk menggabungkannya dengan arahan visual lain seperti logo tambahan ikon.

Gunakan atribut clip-path CSS untuk menanam unsur-unsur ke dalam bentuk tersuai, seperti segitiga, takik bulat, poligon, dan lain-lain, tanpa bergantung pada gambar atau SVG. Kelebihannya termasuk: 1. Menyokong pelbagai bentuk asas seperti Circle, Ellipse, Polygon, dan lain -lain; 2. Pelarasan responsif dan boleh disesuaikan dengan terminal mudah alih; 3. Mudah untuk animasi, dan boleh digabungkan dengan hover atau javascript untuk mencapai kesan dinamik; 4. Ia tidak menjejaskan aliran susun atur, dan hanya tanaman kawasan paparan. Penggunaan umum adalah seperti laluan klip bulat: bulatan (50pxatcenter) dan triangle clip-path: polygon (50%0%, 100 0%, 0 0%). Notis

Untuk membuat imej responsif menggunakan CSS, ia boleh dicapai terutamanya melalui kaedah berikut: 1. Gunakan maksimum lebar: 100% dan ketinggian: auto untuk membolehkan imej menyesuaikan diri dengan lebar kontena sambil mengekalkan perkadaran; 2. Gunakan atribut SRCSET dan saiz HTML dengan bijak memuatkan sumber imej yang disesuaikan dengan skrin yang berbeza; 3. Gunakan objek-sesuai dan kedudukan objek untuk mengawal penanaman imej dan paparan fokus. Bersama -sama, kaedah ini memastikan bahawa imej dibentangkan dengan jelas dan indah pada peranti yang berbeza.

Pilihan unit CSS bergantung kepada keperluan reka bentuk dan keperluan responsif. 1.PX digunakan untuk saiz tetap, sesuai untuk kawalan yang tepat tetapi kekurangan keanjalan; 2.EM adalah unit relatif, yang mudah disebabkan oleh pengaruh unsur induk, sementara REM lebih stabil berdasarkan unsur akar dan sesuai untuk skala global; 3.VW/VH didasarkan pada saiz viewport, sesuai untuk reka bentuk yang responsif, tetapi perhatian harus dibayar kepada prestasi di bawah skrin yang melampau; 4. Apabila memilih, ia harus ditentukan berdasarkan sama ada pelarasan responsif, hubungan hierarki elemen dan ketergantungan viewport. Penggunaan yang munasabah boleh meningkatkan fleksibiliti dan penyelenggaraan susun atur.

Penyemak imbas yang berbeza mempunyai perbezaan dalam parsing CSS, mengakibatkan kesan paparan yang tidak konsisten, terutamanya termasuk perbezaan gaya lalai, kaedah pengiraan model kotak, flexbox dan tahap sokongan susun atur grid, dan tingkah laku yang tidak konsisten bagi atribut CSS tertentu. 1. Pemprosesan gaya lalai tidak konsisten. Penyelesaiannya adalah menggunakan cssreset atau normalisasi.css untuk menyatukan gaya awal; 2. Kaedah pengiraan model kotak versi lama IE adalah berbeza. Adalah disyorkan untuk menggunakan kotak-kotak: kotak sempadan dengan cara yang bersatu; 3. Flexbox dan grid melakukan secara berbeza dalam kes kelebihan atau dalam versi lama. Lebih banyak ujian dan gunakan autoprefixer; 4. Beberapa tingkah laku atribut CSS tidak konsisten. CANIUSE mesti dirujuk dan diturunkan.
