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:

A basic block

{{{
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":

syntax highlighting for a shell script

{{{ 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":

syntax highlighting with a specific line indicated

{{{ 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.

Indented nested lists

* first level
  **  second level
* first level

becomes:

first level
- second level
first level

* 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:

syntax highlighting with an indented final line

* first level
  **  second level

becomes:

first level
- second level

Correct with:

* first level
  **  second level
* %%

=>

first level
- second level

* 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.

syntax highlighting with the final line indented, within a tag

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

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 ∞

A link with character codes

[[https://example.com |This &#91; is &#124; an &#93; example]]

This [ is | an ] example

[[https://example.com |This &#91; is &#124; an &#93; example]]

This [ is | an ] example

Table cells with "0" are removed ∞

https://github.com/skrysmanski/blogtext/issues/36

|         0 |  text

text

|  text

text

2018-09-22 - 0.9.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 pre block. 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 ↖.
- 2024-07-17 - This seems to have been fixed.

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 2024-07-17 at 11:45:35

10 comments on “BlogText”

spiralofhope on 2018-08-28 at 10:56 am said:

Added a CurseForge interlink.

spiralofhope on 2018-09-22 at 3:03 pm said:

Solved a critical error with pages not loading properly.

spiralofhope on 2018-09-24 at 5:26 pm said:

Found a critical error with pages which use my commonly-used table of images. Unsolved.

spiralofhope on 2018-10-03 at 12:26 am said:

Narrowed the PHP 7 display bug to tables.

spiralofhope on 2018-12-30 at 10:22 am said:

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

spiralofhope on 2019-01-01 at 11:38 am said:

Slight update after 0.9.9 though this needs to be gone over with a fine-toothed comb.

spiralofhope on 2020-06-12 at 8:12 pm said:

reported issue 36

spiralofhope on 2021-09-25 at 10:21 am said:

Updated to 0.9.10 and noted the present WordPress and PHP versions being used.

spiralofhope on 2024-02-06 at 4:40 pm said:

RIP

spiralofhope on 2024-07-17 at 11:44 am said:

forked

spiralofhope

BlogText

Customization ∞

Custom CSS ∞

Interlinks ∞

Usage ∞

Syntax Highlighting ∞

Table of Contents ∞

Indenting nested lists ∞

Character codes can still be used in links to display bars ∞

Table cells with "0" are removed ∞

2018-09-22 - 0.9.7 ∞

Misc bugs or annoyances ∞

Some pages do not display due to tables ∞

First test ∞

Second test ∞

Alternatives ∞

10 comments on “BlogText”

Leave a Reply Cancel reply

Search