මාර්ක්ඩවුන් ගොනුවක විවරණයක් ගබඩා කිරීම සඳහා වන වාක්ය ඛණ්ඩය කුමක්ද, උදා: CVS $ Id $ විවරණයක් ගොනුවේ ඉහළින්ම? සලකුණු කිරීමේ ව්යාපෘතියේ මට කිසිවක් හමු නොවීය .
මාර්ක්ඩවුන් ගොනුවක විවරණයක් ගබඩා කිරීම සඳහා වන වාක්ය ඛණ්ඩය කුමක්ද, උදා: CVS $ Id $ විවරණයක් ගොනුවේ ඉහළින්ම? සලකුණු කිරීමේ ව්යාපෘතියේ මට කිසිවක් හමු නොවීය .
Answers:
කලින් යෝජනා කරන ලද සියලුම විසඳුම් (නිශ්චිත ක්රියාත්මක කිරීම් අවශ්ය වන ඒවා හැරුණු විට) ප්රති output ල HTML ප්රතිදානය තුළ ඇතුළත් නොවීමට හේතු වන බව මම විශ්වාස කරමි.
ඔබට දැඩි ලෙස අදහස් දැක්වීමක් අවශ්ය නම් (පරිවර්තනය කළ ලේඛනයේ පා readers කයන්ට එය දැකිය නොහැකි විය යුතුය, “දර්ශන මූලාශ්රය” සමඟ වුවද) ඔබට (අ) සම්බන්ධක ලේබල භාවිතා කළ හැකිය (යොමු ශෛලීය සබැඳි සමඟ භාවිතා කිරීම සඳහා) මූලික මාර්ක්ඩවුන් පිරිවිතරයෙන් ලබා ගත හැකිය:
http://daringfireball.net/projects/markdown/syntax#link
එනම්:
[comment]: <> (This is a comment, it will not be included)
[comment]: <> (in the output file unless you use it in)
[comment]: <> (a reference style link.)
නැතහොත් ඔබට තවත් ඉදිරියට යා හැකිය:
[//]: <> (This is also a comment.)
වේදිකා අනුකූලතාව වැඩි දියුණු කිරීම සඳහා (සහ එක් යතුරු එබීමක් සුරැකීමට #
) ඒ වෙනුවට භාවිතා කළ හැකිය (එය නීත්යානුකූල හයිපර්ලින්ක් ඉලක්කයකි) <>
:
[//]: # (This may be the most platform independent comment)
උපරිම අතේ ගෙන යා හැකි නම්, මේ ආකාරයේ අදහස් දැක්වීමට පෙර සහ පසු හිස් පේළියක් ඇතුළත් කිරීම වැදගත්ය, මන්ද සමහර මාර්ක්ඩවුන් විග්රහයන් සාමාන්ය පෙළට එරෙහිව අර්ථ දැක්වීම් මතුවන විට නිවැරදිව ක්රියා නොකරයි. බාබෙල්මාර්ක් සමඟ කළ නවතම පර්යේෂණයෙන් පෙනී යන්නේ පෙර සහ පසු හිස් රේඛා දෙකම වැදගත් බවයි. මීට පෙර හිස් පේළියක් නොතිබුනේ නම් සමහර පාර්සර්ස් විසින් ප්රකාශය ප්රතිදානය කරනු ඇති අතර, පසුව කිසිදු පේළියක් හිස් රේඛාවක් නොමැති නම් පහත දැක්වෙන රේඛාව බැහැර කරනු ඇත.
පොදුවේ ගත් කල, මෙම ප්රවේශය මූලික පිරිවිතරයේ කොටසක් වන බැවින් බොහෝ මාර්ක්ඩවුන් විග්රහ කරන්නන් සමඟ ක්රියා කළ යුතුය. (බහුවිධ සබැඳි නිර්වචනය කළ විට හෝ සබැඳියක් නිර්වචනය කර ඇති නමුත් කිසි විටෙක භාවිතා නොකළද හැසිරීම තදින් නිශ්චිතව දක්වා නැත).
[//]: # "Comment"
හා [//]: # (Comment)
නිසා වැඩ කිරීමට, ක්රියාවට වඩා පුළුල් විවිධත්වයක් මත පෙනේ #
වලංගු සාපේක්ෂ URI වේ. GitHub, උදාහරණයක් ලෙස, ප්රතික්ෂේප කරන <>
අතර, මුළු රේඛාවම දෘශ්යමාන වේ. සබැඳි ලේබල බොහෝ විට වෙනත් අන්තර්ගතයන්ගෙන් හිස් රේඛාවකින් වෙන් කළ යුතු බව ද සඳහන් කිරීම වටී.
මම වැනි සම්මත HTML ටැග් භාවිතා කරමි
<!---
your comment goes here
and here
-->
ත්රිත්ව ඉරක් සටහන් කරන්න. වාසිය නම් එය ටෙක්ස් හෝ HTML ප්රතිදානය ජනනය කිරීමේදී පැන්ඩොක් සමඟ ක්රියා කිරීමයි. පැන්ඩොක්-සාකච්ඡා කණ්ඩායම පිළිබඳ වැඩි විස්තර ලබා ගත හැකිය .
මෙම කුඩා පර්යේෂණය මැග්නස්ගේ පිළිතුර සනාථ කරයි
වඩාත්ම වේදිකා-ස්වාධීන සින්ටැක්ස් වේ
(empty line)
[comment]: # (This actually is the most platform independent comment)
කොන්දේසි දෙකම වැදගත් ය:
#
(සහ නොවේ <>
)දැඩි මාර්ක්ඩවුන් පිරිවිතරයන් පොදු මාක් ක්රියාත්මක වන්නේ මෙම වාක්ය ඛණ්ඩය සමඟ පමණක් වන අතර ( <>
සහ / හෝ හිස් රේඛාවක් සමඟ නොවේ )
මෙය සනාථ කිරීම සඳහා අපි ජෝන් මැක්ෆාර්ලන් විසින් රචිත බාබල්මාර්ක් 2 භාවිතා කරමු. මෙම මෙවලම මාර්ක්ඩවුන් ක්රියාත්මක කිරීම් 28 කදී විශේෂිත ප්රභව කේත විදැහුම්කරණය පරීක්ෂා කරයි.
( +
- පරීක්ෂණයෙන් -
සමත් විය, ?
- සමත් නොවීය, - විදැහුම් කරන ලද HTML හි නොපෙන්වන කසළ කිහිපයක් ඉතිරි වේ).
<>
13+, 15- භාවිතා කරමින් හිස් රේඛා නොමැත<>
20+, 8- භාවිතා කරමින්<>
20+, 8- භාවිතා කරමින්#
13+ 1 භාවිතා කරමින් හිස් රේඛා නැද්ද? 14-#
23+ 1 භාවිතා කරමින් අදහස් දැක්වීමට පෙර හිස් පේළියක් තිබේද? 4-#
23+ 1 භාවිතා කරමින් අදහස් දැක්වීම වටා හිස් පේළි ? 4-ඉහත ප්රකාශයන් මෙයින් සනාථ වේ.
මෙම ක්රියාත්මක කිරීම් පරීක්ෂණ 7 ම අසමත් වේ. ඔවුන් සමඟ බැහැර කළ විවරණ අදහස් භාවිතා කිරීමට අවස්ථාවක් නොමැත.
#
GFM නමුත් සියලු සඳහා ක්රියා හා <>
GFM සඳහා ක්රියා කිහිපයක් අන් අය නොව. ඉතා නරක GFM යනු මුල්ලක නඩුවක් මෙන්ම ඉතා ජනප්රිය රසයකි.
#
2016 ජනවාරි 21 වන විට ක්රියාත්මක වන බව පෙනේ. සෙබේ තවමත් එය හසුරුවන්නේ නැත.
(...)
තනිවම අඩංගු වන්නේ නම් එය බිඳ දමයි. අවම වශයෙන් දෘශ්ය ස්ටුඩියෝ කේතය 1.19 මත.
%s/^\(.*\)$/[comment]: # (\1)/g
ඔබ ජෙකිල් හෝ බූවල්ලා භාවිතා කරන්නේ නම් පහත සඳහන් දෑ ද ක්රියාත්මක වේ.
{% comment %}
These commments will not include inside the source.
{% endcomment %}
{% comment %}
මාක්ඩවුන් ප්රොසෙසරය ලබා ගැනීමට පෙර ද්රව ටැග් පළමුව විග්රහ කර ඉවත් කරනු ලැබේ. නරඹන්නන් ඔවුන්ගේ බ්රව්සරයෙන් ප්රභවය බැලීමට උත්සාහ කරන විට නොපෙනේ.
{#
මෙහි බහු අදහස් දැක්වීම්#}
විකල්පයක් වන්නේ ශෛලීගත HTML ටැග් තුළ අදහස් දැක්වීම ය. මේ ආකාරයෙන්, ඔබට අවශ්ය පරිදි ඔවුන්ගේ දෘශ්යතාව ටොගල් කළ හැකිය. උදාහරණයක් ලෙස, ඔබේ CSS මෝස්තර පත්රිකාවේ අදහස් දැක්වීමේ පන්තියක් අර්ථ දක්වන්න.
.comment { display: none; }
ඉන්පසුව, පහත දැක්වෙන වැඩි දියුණු කළ MARKDOWN
We do <span class="comment">NOT</span> support comments
බ්රව්සර් හි පහත පරිදි දිස්වේ
We do support comments
මෙය GitHub හි ක්රියාත්මක වේ:
[](Comment text goes here)
එහි ප්රති HTML ලයක් ලෙස HTML පෙනෙන්නේ:
<a href="Comment%20text%20goes%20here"></a>
එය මූලික වශයෙන් හිස් සබැඳියකි. නිසැකවම ඔබට එය විදැහුම් පා text යේ මූලාශ්රයෙන් කියවිය හැකිය, නමුත් ඔබට එය කෙසේ හෝ GitHub හි කළ හැකිය.
some text [](hidden text) blah blah
.
[](Comment text goes here)
<!-- comment -->
එය හොඳින් කරනු ඇත.
Vim Instant-Markdown භාවිතා කරන්නන් භාවිතා කළ යුතුය
<!---
First comment line...
//
_NO_BLANK_LINES_ARE_ALLOWED_
//
_and_try_to_avoid_double_minuses_like_this_: --
//
last comment line.
-->
වැඩිවන මාර්ක්ඩවුන් මෙවලම්වල සහාය ඇතිව විවේචනාත්මක සලකුණු කිරීමද බලන්න.
Comment {>> <<}
Lorem ipsum dolor sit amet.{>>This is a comment<<}
Highlight+Comment {== ==}{>> <<}
Lorem ipsum dolor sit amet, consectetur adipiscing elit. {==Vestibulum at orci magna. Phasellus augue justo, sodales eu pulvinar ac, vulputate eget nulla.==}{>>confusing<<} Mauris massa sem, tempor sed cursus et, semper tincidunt lacus.
විවරණය නොවන, ප්රතිරාවය නොවන R කොටසකට අදහස් දැක්වීම ගැන කුමක් කිව හැකිද? එනම්,
```{r echo=FALSE, eval=FALSE}
All the comments!
```
මට හොඳින් වැඩ කරන බවක් පෙනේ.
cat("# Some Header")
"අදහස් දැක්වීම " කේත කොටස් තුළ භාවිතා කිරීම සහ භාවිතා කිරීම වැනි දේ කිරීමට නිදහස්ව results = "asis"
සිටින්න, සහ eval = FALSE
R ඇගයීම සිදු කිරීමට පෙර ටොගල් කිරීමෙන් සක්රිය / අක්රිය කළ හැකි ඔබේ කේතයට සම්පූර්ණ අදහස් දැක්වීම් කොටස් එකතු කළ හැකිය . පැන්ඩොක් සම්පාදනය. අදහසට ස්තූතියි!
අනාවරණය: මම ප්ලගිනය ලිව්වා.
ප්රශ්නය නිශ්චිත සලකුණු කිරීමේ ක්රියාවලියක් නිශ්චිතව දක්වා නොමැති හෙයින්, ඉහත සඳහන් කළ පැන්ඩොක් අදහස් දැක්වීමේ විලාසය ක්රියාත්මක කරන පයිතන්-මාර්ක්ඩවුන් සඳහා අදහස් ප්ලගිනය සඳහන් කිරීමට මම කැමැත්තෙමි .
<!--- ... -->
Pandoc Markdown හි ක්රියා නොකරයි (Pandoc 1.12.2.1). අදහස් තවමත් html හි පළ විය. පහත සඳහන් දෑ ක්රියාත්මක විය:
Blank line
[^Comment]: Text that will not appear in html source
Blank line
ඉන්පසු + පාදසටහන දිගුව භාවිතා කරන්න. එය අත්යවශ්යයෙන්ම කිසි විටෙක යොමු නොවන පාද සටහනකි.
[#]:
.
පහත සඳහන් දෑ ඉතා හොඳින් ක්රියාත්මක වේ
<empty line>
[whatever comment text]::
බව ක්රමය ප්රයෝජන ලබා ගත සඳහනක් හරහා සබැඳි නිර්මාණය කිරීමට කාරක රීති
නිර්මාණය ලින්ක් සඳහන් සිට [1]: http://example.org
, ඉටු කළ නොහැකි වනු ඇත එසේ ම කිසිදු පහත මෙන්ම ඉටු කළ නොහැකි වනු ඇත
<empty line>
[whatever]::
[whatever]:whatever
[whatever]: :
[whatever]: whatever
pandoc
මෙන්ම Gitlab සහ GitHub හි වර්තමාන මාර්ගගත අවස්ථා සඳහාද ක්රියා කරයි .
පැන්ඩොක් සඳහා, අදහස් දැක්වීම අවහිර කිරීමට හොඳ ක්රමයක් වන්නේ පැන්ඩොක් කතුවරයා යෝජනා කළ පරිදි යම්ල් පරිවෘත්තියක් භාවිතා කිරීමයි . මම මේ අවම වශයෙන් මගේ පරිසරය තුළ අනෙක් යෝජිත විසඳුම්, බොහෝ (සාපේක්ෂව අදහස් තවත් නිසි කාරක රීති අවධාරණය දෙන දැක ඇති vim
, vim-pandoc
සහ vim-pandoc-syntax
).
HTML- අදහස් කැදැල්ල කළ නොහැකි බැවින් මම html-inline අදහස් සමඟ ඒකාබද්ධව yaml block අදහස් භාවිතා කරමි . අවාසනාවකට මෙන්, යම්ල් මෙටාබ්ලොක් තුළ බ්ලොක් අදහස් දැක්වීමේ ක්රමයක් නොමැත , එබැවින් සෑම පේළියක්ම තනි තනිව අදහස් දැක්විය යුතුය. වාසනාවකට මෙන්, මෘදු කළ ඡේදයක එක් පේළියක් පමණක් තිබිය යුතුය.
මගේ ~/.vimrc
, බ්ලොක් අදහස් සඳහා අභිරුචි කෙටිමං සකසා ඇත:
nmap <Leader>b }o<Esc>O...<Esc>{ji#<Esc>O---<Esc>2<down>
nmap <Leader>v {jddx}kdd
මම භාවිතා ,
මගේ ලෙස <Leader>
-key, ඒ නිසා ,b
හා ,v
පිළිවෙළින් අදහස් හා uncomment ඡේදයක්. මට ඡේද කිහිපයක් අදහස් දැක්වීමට අවශ්ය නම්, මම j,b
සාර්ව (සාමාන්යයෙන් Q
) සිතියම් ගත කර ධාවනය කරමි <number-of-paragraphs><name-of-macro>
(උදා ( 3Q
).
kramdown - රූබි මත පදනම් වූ මාර්ක්ඩවුන් එන්ජිම ජෙකිල් සඳහා පෙරනිමිය වන අතර එමඟින් GitHub Pages— එහි විස්තාරණ වාක්ය ඛණ්ඩය හරහා අදහස් දැක්වීමේ සහාය ලබා දී ඇත :
{::comment}
This text is completely ignored by kramdown - a comment in the text.
{:/comment}
Do you see {::comment}this text{:/comment}?
{::comment}some other comment{:/}
පේළිගත අදහස් දැක්වීමට ඉඩ දීමේ වාසිය මෙයට ඇත, නමුත් වෙනත් මාර්ක්ඩවුන් එන්ජින් වෙත අතේ ගෙන යා නොහැකි වීමේ අවාසිය.
ඔබට මෙය කළ හැකිය (YAML block):
~~~
# This is a
# multiline
# comment
...
මම රබර් කිරි ප්රතිදානය සමඟ පමණක් උත්සාහ කළෙමි, කරුණාකර අනෙක් අය සඳහා තහවුරු කරන්න.