this needs to be reworked and re-tested
 |
Software > WordPress > WordPress Plugins >
https://wordpress.org/plugins/blogtext/
https://blogtext.mayastudios.com/
--
- 2021-09-25 - 0.9.10 on WordPress 5.8.1 on PHP 7.4.23
- 2020-06-12 - 0.9.9 on WordPress 5.4.2 on PHP 7.3.18
- 2018-09-22 - 0.9.7 on WordPress 4.9.8 on PHP 7.0.31
- 2018-04-05 - 0.9.7 on WordPress 4.9.5 on PHP 5.6.34
- 2018-03-07 - 0.9.7 on WordPress 4.9.4 on PHP 5.6.33
-
See also My content management system history
Customization ∞
-
Be sure to disable the visual editor in the admin profile.
https://blog.spiralofhope.com/wp-admin/options-general.php?page=blogtext_settings
- Top Level Heading Level 1
[_]Use default icon for external links[_]Use default icon for external HTTPS links[_]Use default icon for attachment links[_]Use default icon for broken internal links-
Theme for code colorizing (aka. syntax highlighting)
[Default: Dark]
Custom CSS ∞
Interlinks ∞
https://blog.spiralofhope.com/wp-admin/options-general.php?page=blogtext_settings
google = https://www.google.com/search?q=$1 search = https://www.google.com/search?q=$1 wiki = https://$1.wikipedia.org/wiki/$2 en = https://en.wikipedia.org/wiki/$1 enwk = https://en.wiktionary.org/wiki/$1 chindict = https://www.mdbg.net/chinese/dictionary?wdqb=$1 wp = https://wow.gamepedia.com/$1 youtube = https://youtu.be/$1 isbn = https://www.amazon.com/gp/search/?field-isbn=$1 git-shell-random = https://github.com/spiralofhope/shell-random/tree/master$1 git-misc-configuration = https://github.com/spiralofhope/misc-configuration/tree/master$1 git-ruby-random = https://github.com/spiralofhope/ruby-random/tree/master$1 git-dos-random = https://github.com/spiralofhope/dos-random/tree/master$1 archive = https://web.archive.org/*/$1 curseforge = https://wow.curseforge.com/projects/$1
Usage ∞
- To display
>as the first character, use > - Display double-percents with %% (%%)
[[RSS]]is a reserved page names-
For some complex table examples, see Tables
Syntax Highlighting ∞
It uses GeSHi. It works well.
- A basic block
You begin with a block, within which no BlogText markup will be processed. So things like bold or links will not work:
{{{
text to apply markup to, ignoring things like **bold** and [[links]]
}}}=>
text to apply markup to, ignoring things like **bold** and [[links]]
- Syntax highlighting
The list of supported languages can be found at within your blog (edit this URL). Here is an example for a shell script, using lang="bash":
{{{ lang="bash"
#!/usr/bin/env sh
# Do stuff:
\echo 'Hello world!'
}}}=>
#!/usr/bin/env sh # Do stuff: \echo 'Hello world!'
You can also use things like highlight="2":
{{{ lang="bash" highlight="2"
#!/usr/bin/env sh
# Do stuff:
\echo 'Hello world!'
}}}=>
#!/usr/bin/env sh # Do stuff: \echo 'Hello world!'
Table of Contents ∞
BlogText has it, and it works well.
[[[TOC]]]
Its output is displayed at the top of this page.
Indenting nested lists ∞
This makes the source for lists vastly more readable.
* first level ** second level * first level
becomes:
-
first level
- second level
- first level
If you have issues with a list, then try adding a bullet ending with %%. In the below example, I indicated them with PERCENTS:
* first level ** second level
becomes:
-
first level
-
second level
-
Correct with:
* first level
** second level
* %%
=>
-
first level
- second level
Another workaround is to put these lists between a tag.
<p>works. This example uses that.<blockquote>works.- Note that invalid tags will work, but that's bad practice.
-
Note that
<div>does not work.
2019-01-01 - I'm not sure what I was describing here..
<x> * first level ** second level on the final line </x> =>
-
first level
- second level on the final line
Character codes can still be used in links to display bars ∞
[[https://example.com |This [ is | an ] example]]
Table cells with "0" are removed ∞
https://github.com/skrysmanski/blogtext/issues/36
| 0 | text
| 0 | text |
| text
| text |
2018-09-22 - 0.9.7 ∞
See also BlogText 0.9.7 on PHP 7
Misc bugs or annoyances ∞
-
I cannot use an interlink to something with quotes in it. It only links to the first word.
- [[en:Clarence "Frogman" Henry|]] => Clarence "Frogman" Henry.
- Fixed in 0.9.9:
-
TODO - I cannot figure out how to have %% (the double-percent comment syntax) displayed in a
preblock. I end up using<blockquote>:- I think this was fixed in 0.9.9 (issue 21)
-
It seems that some unicode characters will get converted from their one-item character into their long-form code. For example, add ↖ and saving a draft will convert it to
↖.
Some pages do not display due to tables ∞
This was fixed some time ago. Closed my ticket.
Demonstrated in:
Further demonstrated in Quiet computing, where the comparison tables can have at most five entries.
First test ∞
{{!
{| class="single-row"
|- valign="top"
| [[image:Windows-3.1-logo-white-background.png| 60px|link=Windows 3.1|Windows 3.1x]]
| [[image:Windows-9598-logo-white-background.png|60px|link=Windows 9x |Windows 9x]]
| [[image:Windows-XP-logo.png| 60px|link=Windows XP |Windows XP]]
| [[image:Windows-7-logo.png| 60px|link=Windows 7 |Windows 7]]
| [[image:Windows-8.1-logo.png| 60px|link=Windows 8.1|Windows 8.1]]
- For some reason, this stopped working within this block
| [[image:Windows-10-logo.png| 60px|link=Windows 10 |Windows 10]]
- This will work if placed without a comment, like so:
| [[image:Windows-10-logo.png| 60px|link=Windows 10|]]
|}
!}}
The broken line works standalone like so:
{{!
{| class="single-row"
|- valign="top"
| [[image:Windows-10-logo.png| 60px|link=Windows 10 |Windows 10]]
|}
!}}
Second test ∞
The first four entries seem to break the display of a page.
{{!
{| class="single-row"
|- valign="top"
| [[image:Flash-Drive-Tester-image.jpg|150px|link=source|Flash Drive Tester]]
| [[image:ChipGenius-screenshot.jpg|150px|link=source|ChipGenius]]
| [[image:h2testw-screenshot.jpg|150px|link=source|hwtest2]]
| [[image:FakeFlashTest-screenshot.jpg|150px|link=source|FakeFlashTest]]
| [[image:RMPrepUSB-screenshot.png|150px|link=source|RMPrepUSB]]
| [[image:usbflashinfo-screenshot.png|150px|link=source|usbflashinfo]]
| [[image:HP-USB-Storage-Format-Tool.png|150px|link=source|HP USB Storage Format Tool]]
| [[image:HP-USB-Storage-Format-Tool-write-protect-error.png|150px|link=source|HP USB Storage Format Tool, write protect error]]
|}
!}}
Alternatives ∞
-
While it implements internal linking with
[[link]], Wiki Page Links is an alternative plugin just for that functionality.
Last updated 2021-09-25 at 10:21:01
Added a CurseForge interlink.
Solved a critical error with pages not loading properly.
Found a critical error with pages which use my commonly-used table of images. Unsolved.
Narrowed the PHP 7 display bug to tables.
Moved 'Saving pages breaks viewing on PHP 7' into 'BlogText 0.9.7 on PHP 7', as it was fixed in BlogText 0.9.8
Slight update after 0.9.9 though this needs to be gone over with a fine-toothed comb.
reported issue 36
Updated to 0.9.10 and noted the present WordPress and PHP versions being used.