Alltså, bäst jag inleder med att säga: dom som kör windows, mac, android eller iphone göre sig icke besvär. Emacs, pandoc, sqlite, zenity, lua, zsh m.fl. kommer avhandlas nedan.
Till att börja med har jag en pandoc writer för wrnu så jag kan skriva inläggen i markdown. Jag lägger in features efter hand jag behöver dom (enligt YAGNI-principen) ex vis kommer jag väl lägga in tabeller förr eller senare. Jag utgår från ett skrälle jag hittade på hubben:
(Ni får byta ut ordet "abborre" mot "code" tydligen går det inte att ha en kod i koden )
Jag har skickat upp dom patches jag kände för, såsom vis LineBlock, andra ändringar har jag inte brytt mig om. Ex vis lade dom in en massa extra drälliga linebreaks i och runt quote och list som jag har tagit bort. Funderar på att skicka upp det med för dom linebreaksen är såvittjagvet semantiska i BBcode/VBcode och ger en fulare output. Men det kan jag ha fått om bakfoten därför att orka.
För att inifrån emacs kunna göra om regions från markdown till wrnu (att det är på region-basis är ibland väldigt smidigt, även om jag ofta tar hela buffern) har jag gjort en enkel liten snutt. (Skickar med den som är till S-G också, där behövdes ingen custom writer eftersom dom använder html):
Pathen till writern får ni ju ändra såklart!
Det som gör markdown så bra är samma sak som det får kritik från av dom som inte fattat: att man kan skriva saker i orginalspråket också. Markdown är inte som Textile att det är en all-ersättande lösning. Det är bara som en liten genväg eller hjälp för dom som ibland tycker det är lättare att skriva *bold* än [*b]bold[*/b] och ibland inte tycker det. Ex vis om man skriver html kan man blanda html och markdown i samma fil, om man skriver wrnu-forum-kod kan man blanda det och markdown i samma fil. Så för att göra länkar har jag skrivit dom på vanlig forumsyntax, har aldrig riktigt vant mig vid markdowns länksyntax. Men… jag är uppenbarligen inte van vid wrnu:s syntax heller för det är fortfarande bland dom vanligaste felen i mina inlägg, att jag mablat till URL-syntaxen. Så idag har jag pillat till en lösning på det.
Jag brukar bara köra wrnu och sg från M-x. Men md-link mappade jag till C-c C-l.
Programmet som gör om söksträng till färdigformaterad link är inte en självklarhet (speciellt om ni inte heter “sandra” och inte har era skalskript i “skami/sh”), jag slängde ihop ett skalskript med zenity och sqlite3 som söker igenom min firefox browsing history för att hitta länken.
Så jag kan till exempel trycka på C-c C-l, skriva in preppar hörna, och få upp en lång lista med länkar, välja en av dom, skriva in en ny titel på den (eller ändra/nöja mig med den hemsidans title-tag), och så klistras det in i markdownformat i buffern. Även om jag inte riktigt är van vid markdowns länksyntax kanske detta kan få mig att bli mer van + det kommer funka till S-G också om jag nu nån gång kommer tillbaka dit efter min välförtjänta och totalt rättvisa och inte alls oproportionerliga rage quit.?
Till att börja med har jag en pandoc writer för wrnu så jag kan skriva inläggen i markdown. Jag lägger in features efter hand jag behöver dom (enligt YAGNI-principen) ex vis kommer jag väl lägga in tabeller förr eller senare. Jag utgår från ett skrälle jag hittade på hubben:
Code:
--[[ ******************************************************************************
* *
* Pandoc 2 BBCode for phpBB *
* *
******************************************************************************
"bbcode_phpbb.lua" v1.1 (2016-12-20)
adapted by Tristano Ajmone (@tajmone):
-- https://github.com/tajmone/2bbcode
------------------------------------------------------------------------------
This code was forked by Tristano Ajmone from @lilydjwg's `2bbcode.lua`:
-- https://github.com/lilydjwg/2bbcode
Copyright (c) 2016, @lilydjwg (??), all rights reserved.
Released under BSD 3-Clause License:
-- https://github.com/lilydjwg/2bbcode/blob/master/LICENSE
==============================================================================
BSD 3-Clause License
==============================================================================
Copyright (c) 2016, ??
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
==============================================================================]]
-- Invoke with: pandoc -t bbcode_phpbb.lua
-- Blocksep is used to separate block elements.
function Blocksep()
return "\n\n"
end
-- This function is called once for the whole document. Parameters:
-- body, title, date are strings; authors is an array of strings;
-- variables is a table. One could use some kind of templating
-- system here; this just gives you a simple standalone HTML file.
function Doc(body, title, authors, date, variables)
return body .. '\n'
end
-- The functions that follow render corresponding pandoc elements.
-- s is always a string, attr is always a table of attributes, and
-- items is always an array of strings (the items in a list).
-- Comments indicate the types of other variables.
function Str(s)
return s
end
function Space()
return " "
end
function LineBreak()
return "\n"
end
-- CHANGES BY @tajmone: Emphasis
-- * Convert to Italic [i] instead of Emphasis [em]
function Emph(s)
return "[I]" .. s .. "[/I]"
end
function Strong(s)
return "[B]" .. s .. "[/B]"
end
function Subscript(s)
error("Subscript isn't supported")
end
function Superscript(s)
return s
end
function SmallCaps(s)
error("SmallCaps isn't supported")
end
-- CHANGES BY @tajmone: Strikeout
-- * Convert to Underline [u] instead of Strikeout/Strikethrough [del]
function Strikeout(s)
return '[U]' .. s .. '[/U]'
end
function Link(s, src, tit)
local ret = '[url'
if s then
ret = ret .. '=' .. src
else
s = src
end
ret = ret .. "]" .. s .. "[/url]"
return ret
end
-- CHANGES BY @tajmone: CaptionedImage
-- * Added CaptionedImage function (missing in original)
-- Caused error for GFM images with Alt text (even if Alt was empty)
function CaptionedImage(src, tit, caption, attr)
return "[img]" .. src .. "[/img]"
end
function Image(s, src, tit)
return "[img=" .. tit .. "]" .. src .. "[/img]"
end
function Code(s, attr)
return "[FONT=courier new]" .. s .. "[/FONT]"
end
function InlineMath(s)
error("InlineMath isn't supported")
end
function DisplayMath(s)
error("DisplayMath isn't supported")
end
function Note(s)
error("Note isn't supported")
end
function Plain(s)
return s
end
function Para(s)
return s
end
-- CHANGES BY @tajmone: Headers 1-6
-- * Don't use [h] (unsupported in phpBB)
-- * Convert to different sizes and colors, always bold.
-- * Higher order headers have bigger font size and more contrasting color.
-- lev is an integer, the header level.
function Header(lev, s, attr)
if lev == 1 then
return "[SIZE=6][B]" .. s .. "[/B][/SIZE]"
elseif lev == 2 then
return "[SIZE=6][B]" .. s .. "[/B][/SIZE]"
elseif lev == 3 then
return "[SIZE=5][B]" .. s .. "[/B][/SIZE]"
elseif lev == 4 then
return "[SIZE=4][B]" .. s .. "[/B][/SIZE]"
elseif lev == 5 then
return "[SIZE=4][B]" .. s .. "[/B][/SIZE]"
else
return "[B]" .. s .. "[/B]"
end
end
function BlockQuote(s)
return "[quote]" .. s .. "[/quote]"
end
function HorizontalRule()
return "--------------------------------------------------------------------------------"
end
function LineBlock(ls)
return table.concat(ls, '\n')
end
function CodeBlock(s, attr)
return "[abborre]\n" .. s .. '\n[/abborre]'
end
function BulletList(items)
local buffer = {}
for _, item in ipairs(items) do
table.insert(buffer, "
[*]" .. item)
end
return "
[LIST]
[*]" .. table.concat(buffer, "\n") .. "
[/LIST]
"
end
function OrderedList(items)
local buffer = {}
for _, item in ipairs(items) do
table.insert(buffer, "
[*]" .. item)
end
return "
[LIST=1]
[*]" .. table.concat(buffer, "\n") .. "
[/LIST]
"
end
-- Revisit association list STackValue instance.
function DefinitionList(items)
local buffer = {}
for _, item in pairs(items) do
for k, v in pairs(item) do
table.insert(buffer, "[B]" .. k .. "[/B]:\n" ..
table.concat(v, "\n"))
end
end
return table.concat(buffer, "\n")
end
-- Convert pandoc alignment to something HTML can use.
-- align is AlignLeft, AlignRight, AlignCenter, or AlignDefault.
function html_align(align)
if align == 'AlignLeft' then
return 'left'
elseif align == 'AlignRight' then
return 'right'
elseif align == 'AlignCenter' then
return 'center'
else
return 'left'
end
end
-- CHANGES BY @tajmone: Table
-- * Now presence of a Table in input doesn't throw an error and abort,
-- it just returns empty string, suppressing the table in converted output!
-- * Warning is printed to STDERR showing the omitted Table's headers
-- (so user can understand what was left out).
-- Caption is a string, aligns is an array of strings,
-- widths is an array of floats, headers is an array of
-- strings, rows is an array of arrays of strings.
function Table(caption, aligns, widths, headers, rows)
local tmpstr = '| '
for i, h in pairs(headers) do
tmpstr = tmpstr .. h .. ' | '
end
PrintWarning('Table omitted: ' .. tmpstr)
return ''
-- error("Table isn't supported")
end
-- CHANGES BY @tajmone: RawBlock
-- * Suppress from output if it's raw HTML
-- (Even html comments were converted to [abborre], and Markdown TOC-tags would show up in final BBCode)
-- * Warning is printed to STDERR with suppresed HTML
function RawBlock(format, str)
if format == "html" then
PrintWarning('Raw HTML omitted: ' .. str)
return ''
else
return '[abbore]\n' .. str .. '\n[/abbore]\n'
end
end
function Span(s, attr)
return s
end
function Div(s, attr)
return s .. '\n'
end
-- The following code will produce runtime warnings when you haven't defined
-- all of the functions you need for the custom writer, so it's useful
-- to include when you're working on a writer.
local meta = {}
meta.__index =
function(_, key)
io.stderr:write(string.format("WARNING: Undefined function '%s'\n",key))
return function() return "" end
end
setmetatable(_G, meta)
-- CHANGES BY @tajmone: DoubleQuoted
-- * Added DoubleQuoted function (missing in original)
-- Caused error for text within double quotes
-- * Returns text in nice UTF-8 curly double quotes (always)
function DoubleQuoted(s)
return "“" .. s .. '”'
end
-- CHANGES BY @tajmone: SingleQuoted
-- * Added SingleQuoted function (missing in original)
-- Caused error for text within single quotes
-- * Returns text in nice UTF-8 curly single quotes (always)
function SingleQuoted(s)
return "‘" .. s .. '’'
end
-- CHANGES BY @tajmone: SoftBreak
-- * Added SoftBreak function (missing in original)
-- This element was added in pandoc 1.16 as a matter of editing convenience
-- to preserve line breaks (as opposed to paragraph breaks) from input source to output.
-- * Returns text followed by \n
function SoftBreak()
return "\n"
end
-- CHANGES BY @tajmone: PrintWarning function
-- * I've added this function to warn the user (on STDERR) when
-- some BBCode-unsupported input is suppressed from output.
function PrintWarning(s)
io.stderr:write("WARNING! " .. s .. '\n')
end
--[[
==============================================================================
FILE HISTORY
==============================================================================
v1.1 - 2016/12/20
- Bug Fix: Added missing fucntions:
- DoubleQuoted()
- SingleQuoted()
- SoftBreak()
v1.0 - 2016/12/10
- Forked from `2bbcode.lua` and created 1st release.
]]
Jag har skickat upp dom patches jag kände för, såsom vis LineBlock, andra ändringar har jag inte brytt mig om. Ex vis lade dom in en massa extra drälliga linebreaks i och runt quote och list som jag har tagit bort. Funderar på att skicka upp det med för dom linebreaksen är såvittjagvet semantiska i BBcode/VBcode och ger en fulare output. Men det kan jag ha fått om bakfoten därför att orka.
För att inifrån emacs kunna göra om regions från markdown till wrnu (att det är på region-basis är ibland väldigt smidigt, även om jag ofta tar hela buffern) har jag gjort en enkel liten snutt. (Skickar med den som är till S-G också, där behövdes ingen custom writer eftersom dom använder html):
Code:
(defun wrnu ()
(interactive)
(shell-command-on-region (mark) (point) "pandoc -St ~/.pandoc/data/wrnu.lua" nil t))
(defun sg ()
(interactive)
(shell-command-on-region (mark) (point) "pandoc -S" nil t))
Det som gör markdown så bra är samma sak som det får kritik från av dom som inte fattat: att man kan skriva saker i orginalspråket också. Markdown är inte som Textile att det är en all-ersättande lösning. Det är bara som en liten genväg eller hjälp för dom som ibland tycker det är lättare att skriva *bold* än [*b]bold[*/b] och ibland inte tycker det. Ex vis om man skriver html kan man blanda html och markdown i samma fil, om man skriver wrnu-forum-kod kan man blanda det och markdown i samma fil. Så för att göra länkar har jag skrivit dom på vanlig forumsyntax, har aldrig riktigt vant mig vid markdowns länksyntax. Men… jag är uppenbarligen inte van vid wrnu:s syntax heller för det är fortfarande bland dom vanligaste felen i mina inlägg, att jag mablat till URL-syntaxen. Så idag har jag pillat till en lösning på det.
Code:
(defun md-link ()
(interactive)
(shell-command (concat "/home/sandra/skami/sh/md_link.sh '" (read-from-minibuffer "Link peps: ") "'") t)
(forward-sexp 2))
(global-set-key (kbd "C-c C-l") 'md-link)
Programmet som gör om söksträng till färdigformaterad link är inte en självklarhet (speciellt om ni inte heter “sandra” och inte har era skalskript i “skami/sh”), jag slängde ihop ett skalskript med zenity och sqlite3 som söker igenom min firefox browsing history för att hitta länken.
Code:
#!/usr/bin/zsh
exec 2>/dev/null
match=$(echo "$*"|sed -e 's/ /%/g' -e 's/^/%/g' -e 's/$/%/g')
get_new_title(){
echo -n $(zenity --entry --entry-text="$(echo "$*" |sed 's/|.*//')")
}
title_fixer() {
echo -n '['$(get_new_title "$*")']('$(echo "$*"|sed 's/.*|//')')'
}
title_fixer $(sqlite3 /home/sandra/.mozilla/firefox/*default/places.sqlite "select title, url from moz_places where url like '${match}' or title like '${match}';"|zenity --list --column Places|head -1)