Re^2: Make a Markup Method in Perl?

in reply to Re: Make a Markup Method in Perl?
in thread Make a Markup Method in Perl?

But I want to reinvent the wheel.

--perl.j

Comment on Re^2: Make a Markup Method in Perl?

Replies are listed 'Best First'.
Re^3: Make a Markup Method in Perl? by roboticus (Chancellor) on May 16, 2012 at 11:02 UTC
perl.j: Ah, so you're doing it as a learning exercise, then? In that case, the first thing I'd do is figure out what the grammar for my markup would be, and what it would mean. Sketch it out on a sheet of paper. Then, start writing code to read the text and parse out your instructions. If it gets nasty, you might change your grammar to simplify it. The roff, troff, etc., layout programs kept their grammar simple by using the rule "if a line begins with a period, then it's a layout command, otherwise it's text". So a marked-up file would look like this: .TH 7z 1 "September 1 2006" "Mohammed Adnene Trojette" + .SH NAME 7z \- A file archiver with highest compression ratio .SH SYNOPSIS .B 7z .BR [adeltux] .BR [\-] .BR [SWITCH] .BR <ARCHIVE_NAME> .BR <ARGUMENTS>... .PP .SH DESCRIPTION 7-Zip is a file archiver with the highest compression ratio. The progr +am supports 7z (that implements LZMA compression algorithm), ZIP, CAB +, ARJ, GZIP, BZIP2, TAR, CPIO, RPM and DEB formats. Compression ratio + in the new 7z format is 30-50% better than ratio in ZIP format. .TP 7z uses plugins to handle archives. .PP [download] This is the first few lines of the man page for 7z. The man system in NIX uses roff formatted files. On most(?) Linux systems, you can read `man 7 groff` to get details on the grammar used. ...roboticus When your only tool is a hammer, all problems look like your thumb.	[reply] [d/l] [select]

Replies are listed 'Best First'.

Re^3: Make a Markup Method in Perl?
by roboticus (Chancellor) on May 16, 2012 at 11:02 UTC

perl.j:

Ah, so you're doing it as a learning exercise, then? In that case, the first thing I'd do is figure out what the grammar for my markup would be, and what it would mean. Sketch it out on a sheet of paper. Then, start writing code to read the text and parse out your instructions. If it gets nasty, you might change your grammar to simplify it.

The roff, troff, etc., layout programs kept their grammar simple by using the rule "if a line begins with a period, then it's a layout command, otherwise it's text". So a marked-up file would look like this:

.TH 7z 1 "September 1 2006" "Mohammed Adnene Trojette"                
+                                                            
.SH NAME
7z \- A file archiver with highest compression ratio
.SH SYNOPSIS
.B 7z
.BR [adeltux]
.BR [\-]
.BR [SWITCH]
.BR <ARCHIVE_NAME>
.BR <ARGUMENTS>...
.PP
.SH DESCRIPTION
7-Zip is a file archiver with the highest compression ratio. The progr
+am supports 7z (that implements LZMA compression algorithm), ZIP, CAB
+, ARJ, GZIP, BZIP2, TAR, CPIO, RPM and DEB formats. Compression ratio
+ in the new 7z format is 30-50% better than ratio in ZIP format.
.TP
7z uses plugins to handle archives.
.PP
[download]

This is the first few lines of the man page for 7z. The man system in *NIX uses *roff formatted files. On most(?) Linux systems, you can read man 7 groff to get details on the grammar used.

...roboticus

When your only tool is a hammer, all problems look like your thumb.

[reply]
[d/l]
[select]

In Section Seekers of Perl Wisdom