mirror of
https://github.com/seigler/dash-docs
synced 2025-07-27 17:56:16 +00:00
1634212dd5
Adds to the devel reference page detailed documentation on the following messages: block, getblocks, getdata, getheaders, headers, inv, mempool, merkleblock, notfound, and tx. Adds to the devel examples page an example of requesting and parsing a merkleblock message. Adds to the devel docs overview pages links to the above two new P2P sections. Tweaks the autocrossref plugin ignore pattern to not crossref in the middle of a GIF image name; this allows the inclusion of animated GIFs.
115 lines
3.7 KiB
Ruby
115 lines
3.7 KiB
Ruby
## autocrossref.rb automatically adds cross reference links in documentation
|
|
## texts using the list of words defined in _autocrossref.yaml.
|
|
|
|
## Example:
|
|
## {% autocrossref %}
|
|
## ...content...
|
|
## {% endautocrossref %}
|
|
|
|
## If you have a patten you usually want to match (such as "satoshi"
|
|
## (currency)) but which may appear a few times where you don't want it
|
|
## to match (such as "Satoshi" (name)), append a <!--noref--> HTML comment.
|
|
## E.g.: Bitcoin was invented by Satoshi<!--noref--> Nakamoto.
|
|
|
|
## An alternative match-prevention method, useful for strings inside ``
|
|
## (code) is to make it look to the parser like the string is inside of
|
|
## a do-not-parse [bracket] expression. E.g. [paymentrequest][] would
|
|
## otherwise match this:
|
|
## <!--[-->`src/qt/paymentrequest.proto`<!--]-->
|
|
|
|
module Jekyll
|
|
|
|
require 'yaml'
|
|
|
|
class AutoCrossRefBlock < Liquid::Block
|
|
|
|
def initialize(tag_name, text, tokens)
|
|
super
|
|
end
|
|
|
|
def render(context)
|
|
output = super
|
|
|
|
## Workaround for inconsistent relative directory
|
|
path = File.expand_path(File.dirname(__FILE__)) + "/.."
|
|
## Load terms from file
|
|
site = context.registers[:site].config
|
|
if !site.has_key?("crossref")
|
|
site['crossref'] = YAML.load_file(path + "/_autocrossref.yaml")
|
|
end
|
|
|
|
## Sort terms by reverse length, so longest matches get linked
|
|
## first (e.g. "block chain" before "block"). Otherwise short
|
|
## terms would get linked first and there'd be nothing for long
|
|
## terms to link to.
|
|
site['crossref'].sort_by { |k, v| -k.length }.each { |term|
|
|
|
|
term[1] = term[0] if term[1].nil? || term[1].empty?
|
|
|
|
term[0] = Regexp.escape(term[0])
|
|
|
|
## Replace literal space with \s to match across newlines. This
|
|
## can do weird things if you don't end sentences with a period,
|
|
## such as linking together "standard" and "transactions" in
|
|
## something like this:
|
|
### * RFC1234 is a standard
|
|
###
|
|
### Transactions are cool
|
|
term[0].gsub!('\ ', '\s+')
|
|
|
|
output.gsub!(/
|
|
(?<!\w) ## Don't match inside words
|
|
#{term[0]}('s)? ## Find our key
|
|
(?![^\[]*\]) ## No subst if key inside [brackets]
|
|
(?![^\{]*\}) ## No subst if key inside {braces}
|
|
(?![^\s]*<!--noref-->) ## No subst if <!--noref--> after key
|
|
(?!((?!<pre>).)*(<\/pre>)) ## No subst on a line with a closing pre tag. This
|
|
## prevents matching in {% highlight %} code blocks.
|
|
(?![^\(]*(\.svg|\.png|\.gif)) ## No subst if key inside an image name. This
|
|
## simple regex has the side effect that we can't
|
|
## use .svg, .png, or .gif in non-image base text; if that
|
|
## becomes an issue, we can devise a more complex
|
|
## regex
|
|
(?!\w) ## Don't match inside words
|
|
/xmi) {|s|
|
|
if term[1] == "DO NOT AUTOCROSSREF"
|
|
s.gsub(/( |$)/, "<!--noref-->\\&")
|
|
else
|
|
"[#{s}][#{term[1]}]{:.auto-link}"
|
|
end
|
|
}
|
|
}
|
|
output.gsub!(/<!--.*?-->/m,'') ## Remove all HTML comments
|
|
|
|
output
|
|
end
|
|
end
|
|
end
|
|
|
|
module Jekyll
|
|
|
|
require 'yaml'
|
|
|
|
class AutoCrossRefBlockDisabled < Liquid::Block
|
|
|
|
def initialize(tag_name, text, tokens)
|
|
super
|
|
end
|
|
|
|
def render(context)
|
|
output = super
|
|
|
|
output
|
|
end
|
|
end
|
|
end
|
|
|
|
|
|
|
|
#Do nothing if plugin is disabled
|
|
if !ENV['ENABLED_PLUGINS'].nil? and ENV['ENABLED_PLUGINS'].index('autocrossref').nil?
|
|
print 'Autocrossref disabled' + "\n"
|
|
Liquid::Template.register_tag('autocrossref', Jekyll::AutoCrossRefBlockDisabled)
|
|
else
|
|
Liquid::Template.register_tag('autocrossref', Jekyll::AutoCrossRefBlock)
|
|
end
|