Makefile
author Oleksandr Gavenko <gavenkoa@gmail.com>
Sat, 17 Feb 2024 23:00:15 +0200
changeset 2587 0230a6677c40
parent 2574 ed399b8e9fca
permissions -rw-r--r--
Video Speed Class
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1438
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
     1
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
     2
################################################################
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
     3
# Standard GNU Makefile settings.
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
     4
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     5
SHELL = /bin/sh
923
f3b193a0e566 Add work-around for PATH. Under Windows find.exe going in collision with
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 905
diff changeset
     6
export PATH := /bin:/usr/bin:${PATH}
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     7
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     8
# Disable built in pattern rules.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
     9
MAKEFLAGS += -r
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    10
# Disable built in variables.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    11
MAKEFLAGS += -R
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    12
# Disable built in suffix rules.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    13
.SUFFIXES:
1438
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
    14
# Delete target file if command fails.
a53df7bd6722 Delete target file if command fails.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1367
diff changeset
    15
.DELETE_ON_ERROR:
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    16
# Default target.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    17
.DEFAULT_GOAL = all
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    18
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    19
################################################################
1030
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    20
# Platform definition.
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    21
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    22
host_os := linux
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    23
ifneq '' '$(WINDIR)'
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    24
  host_os := cygwin
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    25
endif
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    26
target_os := $(host_os)
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    27
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    28
################################################################
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    29
# Build tool definition/switches.
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    30
1110
6e71ffc71972 small fix
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1109
diff changeset
    31
RST2HTML := rst2html
1030
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    32
ifeq '$(host_os)' 'cygwin'
2188
e95731eef030 Fixed: NameError: name 'locale_encoding' is not defined
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2031
diff changeset
    33
  RST2HTML := LC_ALL=en_US.utf8 rst2html.py
1030
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    34
endif
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    35
1109
9885f6be80f0 Add warning flag for RST utils.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1103
diff changeset
    36
RST_WARNING_FLAGS := --halt warning
1917
d5967d76dae5 Set initial header level to <h2> explicitly because after removing
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1913
diff changeset
    37
RST_RENDER_FLAGS := --strip-comments --embed-stylesheet --no-xml-declaration --math-output=MathJax --initial-header-level=2
1901
12a7d89c74a9 Add template to generate HTML 5 compliant code.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1898
diff changeset
    38
RST_FLAGS := $(RST_WARNING_FLAGS) $(RST_RENDER_FLAGS)
1109
9885f6be80f0 Add warning flag for RST utils.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1103
diff changeset
    39
1030
9162afed7eda Port to Debian.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 928
diff changeset
    40
################################################################
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    41
# Proj dirs/files.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    42
1912
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1909
diff changeset
    43
RST_FILES := $(wildcard *.rst)
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    44
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    45
HTML_DIR := tips-html
1077
509886d148b2 Split values.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1030
diff changeset
    46
RST_HTML_FILES := $(patsubst %.rst,$(HTML_DIR)/%.html,$(RST_FILES))
1103
53b2adcc631e Remove duplication.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1079
diff changeset
    47
HTML_FILES := $(RST_HTML_FILES) \
1893
da0024f4f068 Remove frame based publishing, stick to iframe. Clean CHM code generation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1891
diff changeset
    48
        $(HTML_DIR)/index.html $(HTML_DIR)/iframe.html
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    49
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
    50
CHM_FILES := $(addprefix $(HTML_DIR)/,chm.hhp chm.hhc chm.stp)
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
    51
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    52
DIRS := $(HTML_DIR)
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    53
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
    54
################################################################
1296
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
    55
# Deploy targets.
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
    56
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
    57
WWW_SRV_NAME := tips.defun.work
1883
2e2b67e76e55 Allow customising connection settings.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    58
WWW_SRV_USER := user
2e2b67e76e55 Allow customising connection settings.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    59
HG_SRV_NAME := hg.defun.work
2e2b67e76e55 Allow customising connection settings.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    60
HG_SRV_USER := user
1902
1dd434abf745 Deploy to local WEB server.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1901
diff changeset
    61
LOCAL_DIR := /srv/www/tips
1883
2e2b67e76e55 Allow customising connection settings.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    62
1343
98bd3c148847 Update build info for deploy targets.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1341
diff changeset
    63
ifneq '' '$(filter deploy%,$(MAKECMDGOALS))'
1912
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1909
diff changeset
    64
  $(shell rm -f $(HTML_DIR)/rst.tmpl)
1343
98bd3c148847 Update build info for deploy targets.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1341
diff changeset
    65
endif
98bd3c148847 Update build info for deploy targets.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1341
diff changeset
    66
2012
542525cfb513 For SEO reason I removed tips from SF.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2003
diff changeset
    67
# For SEO reason I removed tips from SF.
1296
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
    68
.PHONY: deploy
2574
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    69
deploy: deploy2defun
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    70
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    71
.PHONY: deploy2defun
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    72
deploy2defun: deploy2defun-web deploy2defun-hg
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    73
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    74
.PHONY: deploy2sf
ed399b8e9fca Added target deploy2defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2188
diff changeset
    75
deploy2sf: deploy2sf-web deploy2sf-hg
1786
e96e62e31370 Deploy to defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1438
diff changeset
    76
2031
6f913ce241e3 Preserve Google and Bind verification pages on deploy.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2012
diff changeset
    77
RSYNC_FLAGS := --delete -avP -e ssh --exclude "google*.html" --exclude "BingSiteAuth.xml"
6f913ce241e3 Preserve Google and Bind verification pages on deploy.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2012
diff changeset
    78
1893
da0024f4f068 Remove frame based publishing, stick to iframe. Clean CHM code generation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1891
diff changeset
    79
# Will be accessible via: http://tips.defun.work/
1786
e96e62e31370 Deploy to defun.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1438
diff changeset
    80
.PHONY: deploy2defun-web
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
    81
deploy2defun-web: www
2031
6f913ce241e3 Preserve Google and Bind verification pages on deploy.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2012
diff changeset
    82
	rsync $(RSYNC_FLAGS) $(HTML_DIR)/ $(WWW_SRV_USER)@$(WWW_SRV_NAME):/srv/www/tips/
1296
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
    83
1843
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1839
diff changeset
    84
.PHONY: deploy2defun-hg
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1839
diff changeset
    85
deploy2defun-hg:
1883
2e2b67e76e55 Allow customising connection settings.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1843
diff changeset
    86
	hg push ssh://$(HG_SRV_USER)@$(HG_SRV_NAME)//srv/hg/tips || [ $$? = 1 ]
1843
8ad4fe7443f2 Point to defun.work to grab sources.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1839
diff changeset
    87
1893
da0024f4f068 Remove frame based publishing, stick to iframe. Clean CHM code generation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1891
diff changeset
    88
# Will be accessible via: http://gavenkoa.users.sourceforge.net/tips-html/
1349
b4e60ae7e4bf Push sources on 'deploy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1345
diff changeset
    89
.PHONY: deploy2sf-web
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
    90
deploy2sf-web: www
2031
6f913ce241e3 Preserve Google and Bind verification pages on deploy.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2012
diff changeset
    91
	rsync $(RSYNC_FLAGS) $(HTML_DIR)/ gavenkoa@frs.sourceforge.net:/home/user-web/g/ga/gavenkoa/htdocs/tips-html/
1296
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
    92
1349
b4e60ae7e4bf Push sources on 'deploy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1345
diff changeset
    93
.PHONY: deploy2sf-hg
b4e60ae7e4bf Push sources on 'deploy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1345
diff changeset
    94
deploy2sf-hg:
1366
c57cd27e840e If 'hg' found no changes it report error code 1. Ignore them as it is valid.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1349
diff changeset
    95
	hg push ssh://gavenkoa@hg.code.sf.net/u/gavenkoa/tips || [ $$? = 1 ]
1349
b4e60ae7e4bf Push sources on 'deploy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1345
diff changeset
    96
1902
1dd434abf745 Deploy to local WEB server.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1901
diff changeset
    97
.PHONY: deploy2local
1dd434abf745 Deploy to local WEB server.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1901
diff changeset
    98
deploy2local: html
1925
f753d84e666e Use HTML_DIR variable instead of exact value.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1917
diff changeset
    99
	rsync --delete -avP $(HTML_DIR)/ $(LOCAL_DIR)
1902
1dd434abf745 Deploy to local WEB server.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1901
diff changeset
   100
1296
6b365616ac9e Add 'deploy2sourceforge' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1111
diff changeset
   101
################################################################
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   102
# Build targets.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   103
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   104
.PHONY: all
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   105
all:
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   106
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   107
.PHONY: www
2003
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   108
www: html $(HTML_DIR)/sitemap.xml $(HTML_DIR)/robots.txt
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   109
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   110
.PHONY: html
1907
f4b078cbff20 TXT files no longer used.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1902
diff changeset
   111
html: $(HTML_FILES)
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   112
2001
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   113
$(HTML_DIR)/%.html: %.rst www/rst.css www/rst-multi.css $(HTML_DIR)/rst.tmpl $(MAKEFILE_LIST) | $(HTML_DIR)
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   114
	$(RST2HTML) $(RST_FLAGS) --stylesheet=www/rst.css,www/rst-multi.css --template=$(HTML_DIR)/rst.tmpl $*.rst $@
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   115
1889
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   116
$(HTML_DIR)/iframe.html: $(RST_FILES) $(MAKEFILE_LIST) | $(HTML_DIR)
1334
9bf0d5a1f0cf Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1333
diff changeset
   117
	{ \
1898
2a18c31747dc set encoding for iframe navigation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1897
diff changeset
   118
echo '<html><head>'; \
2a18c31747dc set encoding for iframe navigation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1897
diff changeset
   119
echo '<meta charset="utf-8">'; \
2a18c31747dc set encoding for iframe navigation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1897
diff changeset
   120
echo '<style>'; \
1891
471406f3c69c Apply consistent color schema. Remove duplicated links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1890
diff changeset
   121
echo 'a { text-decoration: none; color: hsl(240, 100%, 50%); }'; \
1897
200fac373cf9 Highlight links on hover.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1893
diff changeset
   122
echo 'a:hover { opacity: .5; }'; \
1891
471406f3c69c Apply consistent color schema. Remove duplicated links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1890
diff changeset
   123
echo '</style></head><body>'; \
1889
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   124
echo '<ul style="padding-left: 1em;">'; \
1891
471406f3c69c Apply consistent color schema. Remove duplicated links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1890
diff changeset
   125
for f in $(sort $(RST_FILES)); do \
1889
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   126
  n=$${f%.rst}; \
1893
da0024f4f068 Remove frame based publishing, stick to iframe. Clean CHM code generation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1891
diff changeset
   127
  printf '<li><a target="_parent" href="%s.html">%s</a></li>\n' $$n $$n; \
1889
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   128
done; \
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   129
echo '</ul>'; \
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   130
echo '</body></html>'; \
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   131
} >$@
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   132
2003
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   133
$(HTML_DIR)/rst.tmpl: www/rst.tmpl $(MAKEFILE_LIST) | $(HTML_DIR)
1912
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1909
diff changeset
   134
	sed -e "s|{date}|$$(date +%F)|" -e "s|{rev}|$$(hg id -i)|"  <$< >$@
1334
9bf0d5a1f0cf Include common header with quick links.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1333
diff changeset
   135
1889
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   136
$(HTML_DIR)/index.html: $(HTML_DIR)/README.html $(MAKEFILE_LIST) | $(HTML_DIR)
265b8d0f6149 Generate UX friendly index.html with iframe to tips index.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1883
diff changeset
   137
	cp $< $@
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   138
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   139
.PHONY: chm
1893
da0024f4f068 Remove frame based publishing, stick to iframe. Clean CHM code generation.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1891
diff changeset
   140
chm: html $(CHM_FILES) $(HTML_DIR)/iframe.html
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   141
	cd $(HTML_DIR); for file in *.html; do sed -i '/<\?xml.*\?>/d' $$file; done
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   142
2001
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   143
$(HTML_DIR)/%.stp: misc/%.stp $(MAKEFILE_LIST) | $(HTML_DIR)
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   144
	cp $< $@
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   145
2001
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   146
$(HTML_DIR)/chm.hhp: misc/chm-hhp.sh $(MAKEFILE_LIST) | $(HTML_DIR)
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   147
	./$<  >$@
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   148
2001
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   149
$(HTML_DIR)/chm.hhc: misc/chm-hhc.sh $(MAKEFILE_LIST) | $(HTML_DIR)
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   150
	./$<  >$@
903
9ead7d97be34 Add chm output format.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 902
diff changeset
   151
1908
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   152
.PHONY: single-html
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   153
single-html: $(HTML_DIR)/single.html
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   154
2001
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   155
$(HTML_DIR)/single.html: $(HTML_DIR)/single.rest www/rst.css www/rst-single.css $(RST_FILES)
4bebef342260 Move template files to separate directories.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2000
diff changeset
   156
	$(RST2HTML) $(RST_FLAGS) --stylesheet=www/rst.css,www/rst-single.css $(HTML_DIR)/single.rest $@
1908
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   157
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   158
$(HTML_DIR)/single.rest: $(RST_FILES) $(MAKEFILE_LIST)
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   159
	{ \
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   160
echo ".. contents::"; \
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   161
echo "   :local:"; \
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   162
echo; \
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   163
for f in *.rst; do echo ".. include:: ../$$f"; done; \
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   164
} >$@
0260f8ffef35 Generate single HTML build.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1907
diff changeset
   165
2003
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   166
$(HTML_DIR)/sitemap.xml: $(RST_FILES) $(MAKEFILE_LIST) | $(HTML_DIR)
2000
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   167
	{ \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   168
echo '<?xml version="1.0" encoding="UTF-8"?>'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   169
echo '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   170
for f in *.rst iframe; do \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   171
  echo '<url>'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   172
  echo "  <loc>http://$(WWW_SRV_NAME)/$${f%.rst}.html</loc>"; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   173
  echo '  <changefreq>weekly</changefreq>'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   174
  echo '</url>'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   175
done; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   176
echo '</urlset>'; \
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   177
} >$@
7bfe538a4cfe Generate sitemap.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1925
diff changeset
   178
2003
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   179
$(HTML_DIR)/robots.txt: www/robots.txt $(MAKEFILE_LIST) | $(HTML_DIR)
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   180
	cp $< $@
aa322acc9627 Add robots.txt.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 2001
diff changeset
   181
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   182
################################################################
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   183
# Init targets.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   184
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   185
$(DIRS):
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   186
	mkdir -p $@
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   187
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   188
################################################################
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   189
# Clean targets.
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   190
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   191
.PHONY: distclean
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   192
distclean: clean
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   193
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   194
.PHONY: clean
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   195
clean:
1912
8b81a8f0f692 Remove HEADER.rst because that info now added to HTML template.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1909
diff changeset
   196
	rm -r -f $(DIRS)
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   197
928
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   198
################################################################
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   199
# Helper target.
902
034aeeb2a16d Build html version of tips.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents:
diff changeset
   200
1345
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   201
.PHONY: help
928
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   202
help:
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   203
	@echo Supported targets:
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   204
	@sed -n -e '/^[[:alnum:]_-]*:/{s=^\(.*\):.*=  \1=;p;}' $(MAKEFILE_LIST)
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   205
1345
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   206
.PHONY: check-format-policy
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   207
check-format-policy:
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   208
	\
1909
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   209
for f in $(RST_FILES); do \
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   210
  if grep '^.. -\*- coding: utf-8; -\*-' $$f >/dev/null; then :; else \
1345
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   211
    echo $$f:1:" Has no 'coding: utf-8' directive."; \
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   212
  fi; \
1909
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   213
  if grep '^.. contents::' $$f >/dev/null; then :; else \
1345
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   214
    echo $$f:7:" Has no 'contents::' directive."; \
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   215
  fi; \
1909
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   216
  if grep '^   :local:' $$f >/dev/null; then :; else \
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   217
    echo $$f:7:" Has no ':local:' directive."; \
6b76120bd2d3 Check for presents of :local: keyword.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1908
diff changeset
   218
  fi; \
1345
a1dffeaaf6e4 Add 'check-format-policy' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 1343
diff changeset
   219
done
928
05c1f958d465 Add 'help' target.
Oleksandr Gavenko <gavenkoa@gmail.com>
parents: 927
diff changeset
   220