scummvm/dists/amigaos/md2ag.rexx
2021-08-28 21:01:11 +02:00

160 lines
4.6 KiB
Rexx

/*
$VER: md2ag.rexx 0.1 (25.05.2021) README(.md) to (amiga).guide converter.
Converts a given markdown README file to a basic hypertext Amiga guide file
and installs it to a given location.
*/
PARSE ARG p_readme p_instpath
/*
Check if arguments are available, otherwise quit.
*/
IF ~ARG() THEN DO
SAY 'No Arguments given!'
SAY 'Usage: md2ag.rexx README.md INSTALLPATH'
EXIT
END
/*
If the given filename/path has spaces in it, AmigaDOS/CLI
will add extra quotation marks to secure a sane working path.
Get rid of them to make AREXX find the file and remove leading
and trailing spaces.
*/
IF ~EXISTS(p_readme) THEN DO
SAY p_readme' not available!'
EXIT
END
ELSE DO
p_readme=STRIP(p_readme)
p_readme=COMPRESS(p_readme,'"')
END
IF p_instpath='' THEN DO
SAY 'No installation destination given!'
EXIT
END
ELSE DO
p_instpath=STRIP(p_instpath)
p_instpath=STRIP(p_instpath,'T','/')
p_instpath=COMPRESS(p_instpath,'"')
END
/*
Convert README.md to ASCII to get rid of non-displayable characters.
*/
ADDRESS COMMAND 'iconv -f UTF-8 -t ASCII//TRANSLIT 'p_readme' >README.conv'
CALL OPEN read_md,'README.conv','R'
IF READCH(read_md,18)~='# [ScummVM README]' THEN DO
CALL CLOSE read_md
SAY p_readme' is not the ScummVM README.md file. Aborting!'
EXIT
END
ELSE
/*
Skip the first "Build Status" line.
*/
CALL READLN read_md
CALL OPEN write_guide,'README.guide','W'
/*
Prepare Amiga guide, add intro and fixed text.
*/
CALL WRITELN write_guide,'@DATABASE ScummVM README.guide'
CALL WRITELN write_guide,'@$VER: ScummVM Readme 2.4.0git'
CALL WRITELN write_guide,'@(C) by The ScummVM team'
CALL WRITELN write_guide,'@AUTHOR The ScummVM team'
CALL WRITELN write_guide,'@WORDWRAP'
CALL WRITELN write_guide,'@NODE "main" "ScummVM README Guide"'
CALL WRITELN write_guide,'@{b}'
CALL WRITELN write_guide,'ScummVM README'
CALL WRITELN write_guide,'@{ub}'
DO WHILE ~EOF(read_md)
v_line=READLN(read_md)
/*
Handle one rolled over line that cuts a weblink.
Lines 11, 12 and 13 in the original .md file hold a weblink which is cut short.
Rejoin lines 12 and 13 to fix the otherwise cut link.
Lines are:
"latest release, progress reports and more, please visit the ScummVM [home
page](https://www.scummvm.org/)"
*/
IF POS('[',v_line)>0 THEN DO
IF POS(']',v_line)=0 THEN DO
rejoin_line=READLN(read_md)
v_line=v_line''rejoin_line
END
END
/*
Change local markdown links to AmigaGuide ones.
*/
IF POS('[here](',v_line)>0 THEN DO
v_locallink=SUBSTR(v_line,POS('(',v_line)+1,POS(')',v_line)-POS('(',v_line)-1)
v_line=DELSTR(v_line,POS('(',v_line)+1,POS(')',v_line)-POS('(',v_line)-1)
v_line=INSERT('@{"'v_locallink'" link 'v_locallink'/main}',v_line,POS(']',v_line)+1)
END
/*
Change html markdown links to AmigaGuide ones.
*/
IF POS('http',v_line)>0 THEN DO
v_protocol=UPPER(SUBSTR(v_line,POS('http',v_line),POS('://',v_line)-POS('http',v_line)))
IF POS('(http',v_line)>0 THEN DO
v_weblink=SUBSTR(v_line,POS('(',v_line)+1,POS(')',v_line)-POS('(',v_line)-1)
v_weblink=COMPRESS(v_weblink,'>')
v_line=DELSTR(v_line,POS('(',v_line)+1,POS(')',v_line)-POS('(',v_line)-1)
v_line=INSERT('@{"'v_weblink'" System "URLOpen 'v_protocol' 'v_weblink'"}',v_line,POS(']',v_line)+1)
END
ELSE DO
v_weblink=SUBSTR(v_line,LASTPOS('<',v_line)+1,LASTPOS('/>',v_line)-LASTPOS('<',v_line)-1)
v_line=DELSTR(v_line,LASTPOS('<',v_line)+1,LASTPOS('>',v_line)-LASTPOS('<',v_line)-1)
v_line=INSERT('@{"'v_weblink'" System "URLOpen 'v_weblink'"}',v_line,LASTPOS('>',v_line)-1)
END
END
/*
Make the "[]" links stand out.
*/
IF POS('[',v_line)>0 THEN DO
v_line=INSERT('@{b}',v_line,POS('[',v_line)-1)
v_line=INSERT('@{ub} ',v_line,POS(']',v_line))
END
/*
There is one long line with two weblinks.
*/
IF POS('[Supported Games]',v_line)>0 THEN DO
v_protocol=UPPER(SUBSTR(v_line,LASTPOS('http',v_line),LASTPOS('://',v_line)-LASTPOS('http',v_line)))
v_weblink=SUBSTR(v_line,LASTPOS('(',v_line)+1,LASTPOS(')',v_line)-LASTPOS('(',v_line)-1)
v_weblink=COMPRESS(v_weblink,'>')
v_line=DELSTR(v_line,LASTPOS('(',v_line)+1,LASTPOS(')',v_line)-LASTPOS('(',v_line)-1)
v_line=INSERT('@{"'v_weblink'" System "URLOpen 'v_protocol' 'v_weblink'"}',v_line,LASTPOS(']',v_line)+1)
v_line=INSERT('@{b}',v_line,LASTPOS('[',v_line)-1)
v_line=INSERT('@{ub} ',v_line,LASTPOS(']',v_line))
END
CALL WRITELN write_guide,v_line
END
/*
Close guide and clean up.
*/
CALL WRITELN write_guide,'@ENDNODE'
CALL CLOSE read_md
CALL CLOSE write_guide
/*
Install finished README.guide to installation path and delete README.guide.
*/
ADDRESS COMMAND 'copy README.guide 'p_instpath
ADDRESS COMMAND 'delete quiet README.guide'
ADDRESS COMMAND 'delete quiet README.conv'
EXIT