From f67352938fd43fe4bb9591311173e1601d4edbc7 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Wed, 5 Feb 2014 18:34:16 -0500 Subject: manual Rakefile, README & minor config adjustment --- data/doc/sisu/markup-samples/manual/README | 5 +++++ data/doc/sisu/markup-samples/manual/Rakefile | 25 +++++++++++++++++++--- .../manual/_sisu/rc/sisurc_by_fn.yml | 2 +- .../manual/_sisu/rc/sisurc_by_ft.yml | 2 +- .../manual/_sisu/rc/sisurc_by_lng.yml | 4 ++-- 5 files changed, 31 insertions(+), 7 deletions(-) create mode 100644 data/doc/sisu/markup-samples/manual/README (limited to 'data/doc/sisu/markup-samples') diff --git a/data/doc/sisu/markup-samples/manual/README b/data/doc/sisu/markup-samples/manual/README new file mode 100644 index 00000000..76b55552 --- /dev/null +++ b/data/doc/sisu/markup-samples/manual/README @@ -0,0 +1,5 @@ +ruby ../../../../../bin/sisu6 --txt -v en/README.ssm +ruby ../../../../../bin/sisu6 --txt -v --no-manifest --dump='../../../../../..' en/README.ssm + +ruby ../../../../../bin/sisu6 --manpage -v en/README.ssm +ruby ../../../../../bin/sisu6 --manpage -v --no-manifest --dump='../../../../../../man/man1' en/sisu.ssm diff --git a/data/doc/sisu/markup-samples/manual/Rakefile b/data/doc/sisu/markup-samples/manual/Rakefile index 1d9b5414..e389856f 100644 --- a/data/doc/sisu/markup-samples/manual/Rakefile +++ b/data/doc/sisu/markup-samples/manual/Rakefile @@ -169,7 +169,7 @@ def notice #{project_details.name} #{project_details.rake_project} -This rake file is to assist with having sisu markup files under po4a +This rake file is primarily to assist with having sisu markup files under po4a translation management. It assumes that the source language files are placed under the sub-directory identifying the source language set, which is currently #{language.source} @@ -190,6 +190,15 @@ For a more detailed and up to date task list use: end self end +def generate + def readme + system(%{ruby ../../../../../bin/sisu6 --txt -v --no-manifest --dump='../../../../../..' en/README.ssm}) + end + def manpage + system(%{ruby ../../../../../bin/sisu6 --manpage -v --no-manifest --dump='../../../../../../man/man1' en/sisu.ssm}) + end + self +end def tasks system('rake -T') end @@ -341,8 +350,8 @@ def distclean end #% task lists -desc "runs make (see its description below)" -task :default => [:make] +desc "help" +task :default => [:help] desc "assist with having sisu markup files managed by po4a create configuration files, and language directories and populate them with po4a pot & po files for translation and @@ -369,6 +378,10 @@ and File.directory?(dir.po) else task :make! => [:build_] end +desc "generate sisu manpage sisu.1" +task :manpage => [:manpage_] +desc "generate sisu README" +task :readme => [:readme_] #% task actions task :project_help_ do @@ -401,4 +414,10 @@ end task :notice_rebuild_ do notice.default(:rebuild) end +task :manpage_ do + generate.manpage +end +task :readme_ do + generate.readme +end __END__ diff --git a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_fn.yml b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_fn.yml index f12e3144..7f78f367 100644 --- a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_fn.yml +++ b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_fn.yml @@ -15,7 +15,7 @@ # #all: 'image' #% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name) #webserv: -# url_root: 'http://www.your.url' #without dir stub +# url_root: 'http://www.your.url' #url to document root, without dir stub # path: '/var/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home # images: '_sisu/image' # man: 'man' diff --git a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_ft.yml b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_ft.yml index 71faa3e0..26fff9a0 100644 --- a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_ft.yml +++ b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_ft.yml @@ -15,7 +15,7 @@ # #all: 'image' #% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name) #webserv: -# url_root: 'http://www.your.url' #without dir stub +# url_root: 'http://www.your.url' #url to document root, without dir stub # path: '/var/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home # images: '_sisu/image' # man: 'man' diff --git a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_lng.yml b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_lng.yml index ca1cf424..4ab568ca 100644 --- a/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_lng.yml +++ b/data/doc/sisu/markup-samples/manual/_sisu/rc/sisurc_by_lng.yml @@ -14,8 +14,8 @@ # public: '_sisu/image' # #all: 'image' #% presentation/web directory, main path and subdirectories (most subdirectories are created automatically based on markup directory name) -#webserv: -# url_root: 'http://www.your.url' #without dir stub +webserv: + url_root: 'http://www.sisudoc.org' #url to document root, without dir stub # path: '/var/www' #either (i) / [full path from root] or (ii) ~/ [home] or (iii) ./ [pwd] or (iv) will be made from home # images: '_sisu/image' # man: 'man' -- cgit v1.2.3