development update 2.5.5d0 to be shared on the forum
git-svn-id: https://plugins.svn.wordpress.org/footnotes/trunk@2475227 b8457f37-d9ea-0310-8a92-e5e31aec5664
This commit is contained in:
pewgeuges
parent
ef1137e446
commit
3a341d36b2
31 changed files with 716 additions and 286 deletions
68
development/csscat.sh
Executable file
68
development/csscat.sh
Executable file
|
|
@ -0,0 +1,68 @@
|
|||
#!/bin/bash
|
||||
# 2021-02-15T1839+0100
|
||||
# Last modified: 2021-02-16T0155+0100
|
||||
# csscat.sh
|
||||
# Concatenates CSS files; deletes the concatenations after they’ve been minified.
|
||||
#
|
||||
# 12 unified style sheets are concatenated out of these files:
|
||||
# dev-common.css
|
||||
# dev-tooltips.css
|
||||
# dev-tooltips-alternative.css
|
||||
# dev-layout-reference-container.css
|
||||
# dev-layout-entry-content.css
|
||||
# dev-layout-main-content.css
|
||||
#
|
||||
echo "Running $(dirname "$0")/csscat.sh"
|
||||
if [[ $1 == "c" ]]; then
|
||||
echo "Concatenate in csscat/ for minification:"
|
||||
cd ../css
|
||||
mkdir csscat
|
||||
cat dev-common.css > csscat/footnotes-nottbrpl0.css
|
||||
cat dev-common.css dev-layout-reference-container.css > csscat/footnotes-nottbrpl1.css
|
||||
cat dev-common.css dev-layout-entry-content.css > csscat/footnotes-nottbrpl2.css
|
||||
cat dev-common.css dev-layout-main-content.css > csscat/footnotes-nottbrpl3.css
|
||||
cat dev-common.css dev-tooltips.css > csscat/footnotes-jqttbrpl0.css
|
||||
cat dev-common.css dev-tooltips.css dev-layout-reference-container.css > csscat/footnotes-jqttbrpl1.css
|
||||
cat dev-common.css dev-tooltips.css dev-layout-entry-content.css > csscat/footnotes-jqttbrpl2.css
|
||||
cat dev-common.css dev-tooltips.css dev-layout-main-content.css > csscat/footnotes-jqttbrpl3.css
|
||||
cat dev-common.css dev-tooltips.css dev-tooltips-alternative.css > csscat/footnotes-alttbrpl0.css
|
||||
cat dev-common.css dev-tooltips.css dev-tooltips-alternative.css dev-layout-reference-container.css > csscat/footnotes-alttbrpl1.css
|
||||
cat dev-common.css dev-tooltips.css dev-tooltips-alternative.css dev-layout-entry-content.css > csscat/footnotes-alttbrpl2.css
|
||||
cat dev-common.css dev-tooltips.css dev-tooltips-alternative.css dev-layout-main-content.css > csscat/footnotes-alttbrpl3.css
|
||||
echo "Done."
|
||||
elif [[ $1 == "d" ]]; then
|
||||
echo "Move minified to css/ and delete concatenations and their temp dir:"
|
||||
cd ../css/csscat
|
||||
mv footnotes-nottbrpl0.min.css ..
|
||||
mv footnotes-nottbrpl1.min.css ..
|
||||
mv footnotes-nottbrpl2.min.css ..
|
||||
mv footnotes-nottbrpl3.min.css ..
|
||||
mv footnotes-jqttbrpl0.min.css ..
|
||||
mv footnotes-jqttbrpl1.min.css ..
|
||||
mv footnotes-jqttbrpl2.min.css ..
|
||||
mv footnotes-jqttbrpl3.min.css ..
|
||||
mv footnotes-alttbrpl0.min.css ..
|
||||
mv footnotes-alttbrpl1.min.css ..
|
||||
mv footnotes-alttbrpl2.min.css ..
|
||||
mv footnotes-alttbrpl3.min.css ..
|
||||
cd ..
|
||||
rm -r csscat
|
||||
echo "Done."
|
||||
else
|
||||
echo "Concatenates CSS files; deletes the concatenations after they’ve been minified."
|
||||
echo ""
|
||||
echo "12 unified style sheets are concatenated out of these files:"
|
||||
echo ""
|
||||
echo "dev-common.css"
|
||||
echo ""
|
||||
echo "dev-tooltips.css"
|
||||
echo "dev-tooltips-alternative.css"
|
||||
echo ""
|
||||
echo "dev-layout-reference-container.css"
|
||||
echo "dev-layout-entry-content.css"
|
||||
echo "dev-layout-main-content.css"
|
||||
echo ""
|
||||
echo "Command: c: Concatenate temporary files waiting for minification."
|
||||
echo "Command: d: Move the minified files to css/, delete the temporary."
|
||||
echo "No command, \"--help\", or anything else: Output this help section."
|
||||
fi
|
||||
277
development/customized-documentation-schema.txt
Normal file
277
development/customized-documentation-schema.txt
Normal file
|
|
@ -0,0 +1,277 @@
|
|||
customized-documentation-schema.txt
|
||||
@lastmodified 2021-02-15T2022+0100
|
||||
|
||||
|
||||
Plugin Footnotes for WordPress, v2.5.4 and later
|
||||
|
||||
|
||||
Customized documentation schema
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
|
||||
In community-based, open source projects, it is important to comprehensively
|
||||
recognize, acknowledge and document how developers, testers and users helped
|
||||
build the product.
|
||||
https://wordpress.org/support/topic/great-tool-1549/#post-14039334
|
||||
|
||||
Note: Per the WordPress Coding Standards, the '@author' tag must not be used.
|
||||
https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/
|
||||
|
||||
PHPDOC tag: Role: Acknowledgment in the changelog:
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾ ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾ ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
@contributor Provided code. “thanks to @USERNAME code contribution.”
|
||||
@contributor Provided design. “thanks to @USERNAME design contribution.”
|
||||
@contributor Provided content. “thanks to @USERNAME design contribution.” (!)
|
||||
|
||||
@reporter Reported a bug. “thanks to @USERNAME bug report.”
|
||||
@reporter Reported an issue. “thanks to @USERNAME issue report.”
|
||||
@reporter Requested a feature. “thanks to @USERNAME issue report.” (!)
|
||||
@reporter Provided feedback. “thanks to @USERNAME feedback.”
|
||||
@reporter Provided an example. “thanks to @USERNAME example provision.”
|
||||
|
||||
@user Allowed insight. “thanks to @USERNAME usage.”
|
||||
|
||||
@accountable Edited the codebase. -
|
||||
|
||||
@committer Uploaded a version. -
|
||||
|
||||
|
||||
PHPDOC tags & custom tags
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
2021-01-24T2310+0100
|
||||
2021-02-08T0415+0100
|
||||
|
||||
▲ Source for standard tags:
|
||||
https://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.pkg.html
|
||||
|
||||
@access
|
||||
@author
|
||||
@copyright
|
||||
@deprecated
|
||||
@example
|
||||
@ignore
|
||||
@internal
|
||||
@link
|
||||
@see
|
||||
@since
|
||||
@tutorial
|
||||
@version
|
||||
inline {@internal}}
|
||||
inline {@inheritdoc}
|
||||
inline {@link}
|
||||
|
||||
Sidepane:
|
||||
|
||||
phpDocumentor tags
|
||||
@abstract
|
||||
@access
|
||||
@author
|
||||
@category
|
||||
@copyright
|
||||
@deprecated
|
||||
@example
|
||||
@final
|
||||
@filesource
|
||||
@global
|
||||
@ignore
|
||||
@internal
|
||||
@license
|
||||
@link
|
||||
@method
|
||||
@name
|
||||
@package
|
||||
@param
|
||||
@property
|
||||
@return
|
||||
@see
|
||||
@since
|
||||
@static
|
||||
@staticvar
|
||||
@subpackage
|
||||
@todo
|
||||
@tutorial
|
||||
@uses
|
||||
@var
|
||||
@version
|
||||
|
||||
phpDocumentor Inline tags
|
||||
inline {@example}
|
||||
inline {@id}
|
||||
inline {@internal}}
|
||||
inline {@inheritdoc}
|
||||
inline {@link}
|
||||
inline {@source}
|
||||
inline {@toc}
|
||||
inline {@tutorial}
|
||||
|
||||
|
||||
▲ Tags required/recommended by WordPress coding standard:
|
||||
https://developer.wordpress.org/coding-standards/inline-documentation-standards/php/
|
||||
|
||||
Note: The only tag added from draft PSR-5 recommendations is @type.
|
||||
https://stackoverflow.com/questions/48202550/source-of-type-tag-in-docblock
|
||||
|
||||
@access
|
||||
@author [DO NOT USE]
|
||||
@copyright
|
||||
@deprecated
|
||||
@global
|
||||
@ignore
|
||||
@internal
|
||||
@license
|
||||
@link
|
||||
@method
|
||||
@package
|
||||
@param
|
||||
@return
|
||||
@see
|
||||
@since
|
||||
@static
|
||||
@staticvar
|
||||
@subpackage
|
||||
@todo
|
||||
@type
|
||||
@uses
|
||||
@var
|
||||
|
||||
|
||||
▲ Tags added by PHPStan:
|
||||
https://phpstan.org/blog/generics-in-php-using-phpdocs
|
||||
|
||||
@extends
|
||||
@implements
|
||||
@template
|
||||
|
||||
|
||||
▲ Tags supported in Atom TextMate found in VS Code 1.47.3:
|
||||
/usr/share/code/resources/app/extensions/php/syntaxes/php.tmLanguage.json
|
||||
Note the 4 tags appended to the list, hence initially missing.
|
||||
|
||||
@api
|
||||
@abstract
|
||||
@author
|
||||
@category
|
||||
@copyright
|
||||
@example
|
||||
@global
|
||||
@inherit[Dd]oc
|
||||
@internal
|
||||
@license
|
||||
@link
|
||||
@method
|
||||
@property(-(read|write))?
|
||||
@package
|
||||
@param
|
||||
@return
|
||||
@see
|
||||
@since
|
||||
@source
|
||||
@static
|
||||
@subpackage
|
||||
@throws
|
||||
@todo
|
||||
@var
|
||||
@version
|
||||
@uses
|
||||
@deprecated
|
||||
@final
|
||||
@ignore
|
||||
|
||||
MISSING TAGS:
|
||||
|
||||
- wrt phpDocumentor:
|
||||
@access
|
||||
@filesource
|
||||
@id
|
||||
@name
|
||||
@staticvar
|
||||
@toc
|
||||
@tutorial
|
||||
@usedby
|
||||
|
||||
- wrt WordPress:
|
||||
@type
|
||||
|
||||
- wrt PHPStan:
|
||||
@extends
|
||||
@implements
|
||||
@template
|
||||
|
||||
|
||||
▲ up-to-date list (standard/WP/PHPStan, custom):
|
||||
|
||||
@api
|
||||
@abstract
|
||||
@access
|
||||
@author
|
||||
@category
|
||||
@copyright
|
||||
@deprecated
|
||||
@example
|
||||
@extends
|
||||
@filesource
|
||||
@final
|
||||
@global
|
||||
@id
|
||||
@ignore
|
||||
@implements
|
||||
@inherit[Dd]oc
|
||||
@internal
|
||||
@license
|
||||
@link
|
||||
@method
|
||||
@name
|
||||
@package
|
||||
@param
|
||||
@property(-(read|write))?
|
||||
@return
|
||||
@see
|
||||
@since
|
||||
@source
|
||||
@static
|
||||
@staticvar
|
||||
@subpackage
|
||||
@template
|
||||
@throws
|
||||
@toc
|
||||
@todo
|
||||
@tutorial
|
||||
@type
|
||||
@usedby
|
||||
@uses
|
||||
@var
|
||||
@version
|
||||
|
||||
@accountable
|
||||
@bib
|
||||
@biblio
|
||||
@callback
|
||||
@commit
|
||||
@committer
|
||||
@contributor
|
||||
@courtesy
|
||||
@date
|
||||
@datetime
|
||||
@lastmodified
|
||||
@modified
|
||||
@publisher
|
||||
@reporter
|
||||
@user
|
||||
|
||||
|
||||
▲ Config (original, missing and added tags), example of VS Code
|
||||
/usr/share/code/resources/app/extensions/php/syntaxes/php.tmLanguage.json
|
||||
|
||||
original:
|
||||
abstract|api|author|category|copyright|deprecated|example|final|global|ignore|inherit[Dd]oc|internal|license|link|method|package|param|property(-(read|write))?|return|see|since|source|static|subpackage|throws|todo|uses|var|version
|
||||
|
||||
missing:
|
||||
|access|filesource|id|name|staticvar|toc|tutorial|usedby
|
||||
|
||||
WordPress:
|
||||
|type
|
||||
|
||||
PHPStan:
|
||||
|extends|implements|template
|
||||
|
||||
custom:
|
||||
|accountable|bib|biblio|callback|commit|committer|contributor|courtesy|date|datetime|lastmodified|modified|publisher|reporter|user
|
||||
47
development/customized-template-stack.txt
Normal file
47
development/customized-template-stack.txt
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
customized-template-stack.txt
|
||||
@date 2020-12-19T0609+0100
|
||||
@lastmodified 2021-02-15T2027+0100
|
||||
|
||||
|
||||
Plugin Footnotes for WordPress, v2.5.3 and later
|
||||
|
||||
|
||||
A. Customized template parts
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
|
||||
@since 2.2.6 Adding: Templates: support for custom templates in sibling folder, thanks to @misfist issue report.
|
||||
@since 2.5.0 Adding: Templates: Enable template location stack, thanks to @misfist code contribution.
|
||||
|
||||
|
||||
Priority order:
|
||||
1. active theme
|
||||
2. sibling folder
|
||||
3. internal
|
||||
|
||||
See footnotes/class/template.php:67..116
|
||||
|
||||
|
||||
1. Active theme
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
Please create a folder 'templates/footnotes/' in your child theme and
|
||||
store all your public custom templates for Footnotes directly therein.
|
||||
|
||||
Existing homonymous templates are loaded instead of their counterparts in
|
||||
wp-content/plugins/footnotes/templates/public/.
|
||||
|
||||
|
||||
2. Sibling folder
|
||||
‾‾‾‾‾‾‾‾‾‾‾‾‾‾
|
||||
Please make a sibling of the "footnotes" folder called 'footnotes-custom' and
|
||||
the same internal structure and file names as 'footnotes/templates/public/'.
|
||||
|
||||
Example for custom tooltips:
|
||||
|
||||
footnotes-custom
|
||||
└── templates
|
||||
└── public
|
||||
├── footnote.html
|
||||
└── tooltip.html
|
||||
|
||||
Note: The timing parameters in the inline jQuery script 'tooltip.html' are already
|
||||
configurable in the dashboard > Referrers and tooltips > Tooltip timing.
|
||||
Reference in a new issue