elvish/website/Makefile

TOOLS_DIR := ./tools
DST_DIR = ./_dst
PUBLISH_DIR := ./_publish

MDS := home.md $(filter-out %/README.md,$(wildcard [^_]*/*.md))
HTMLS := $(MDS:.md=.html)

TOOLS := highlight macros elvdoc genblog

default: gen

%.html: %.md $(TOOL_BINARIES) $(TOOLS_DIR)/md-to-html
	$(TOOLS_DIR)/md-to-html $< $@

# Generates the website into the dst directory.
gen: tools $(HTMLS)
	$(TOOLS_DIR)/genblog.bin . $(DST_DIR)
	ln -sf `pwd`/fonts.css `pwd`/favicons/* $(DST_DIR)/

tools:
	for tool in $(TOOLS); do \
		go build -o $(TOOLS_DIR)/$$tool.bin ./cmd/$$tool; \
	done

genblog:
	: # a nop, kept for backward compatibility with elves/up
	
# Synchronizes the generated website into $(PUBLISH_DIR). The PUBLISH_DIR
# environment variable can be overridden to a remote place to publish this online.
publish: gen
	rsync -aLv --delete ./_dst/ $(PUBLISH_DIR)/

clean:
	rm -f $(HTMLS) _tools/*.bin
	rm -rf $(DST_DIR)

.PHONY: default gen tools genblog publish clean
.SECONDARY: $(TOOL_BINARIES)
website: Restructure directory. * Remove the _ prefix from directories. * Move cmd/website -> website/cmd. 2020-06-14 20:56:58 +08:00			`TOOLS_DIR := ./tools`
website: Reorganize. Every subdirectory other than src/ now has a _ prefix. The content of src/ is moved into the root of website directory itself. 2018-08-28 03:57:51 +08:00			`DST_DIR = ./_dst`
			`PUBLISH_DIR := ./_publish`
website: Attempt to fix Makefile for GNU Make >= 4. GNU Make >= 4 seems to behave differently with regards to dependencies with slashes in them. In particular, the dependency on tools/* in the wildcard rule %.html: %.md tools/... does not seem to cause tools/... to be built correctly. Working around this by putting all tools in the root directory, with binaries ending in ".tool". 2018-06-13 05:58:16 +08:00
website: Restructure directory. * Remove the _ prefix from directories. * Move cmd/website -> website/cmd. 2020-06-14 20:56:58 +08:00			`MDS := home.md $(filter-out %/README.md,$(wildcard [^_]/.md))`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00			`HTMLS := $(MDS:.md=.html)`
website: Attempt to fix Makefile for GNU Make >= 4. GNU Make >= 4 seems to behave differently with regards to dependencies with slashes in them. In particular, the dependency on tools/* in the wildcard rule %.html: %.md tools/... does not seem to cause tools/... to be built correctly. Working around this by putting all tools in the root directory, with binaries ending in ".tool". 2018-06-13 05:58:16 +08:00
Vendor the genblog command. This simplifies the website toolchain to no longer depend on an external repository, and allows developing the genblog command in lockstep with the needs of the website. 2020-06-14 19:45:17 +08:00			`TOOLS := highlight macros elvdoc genblog`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00
			`default: gen`

website: Reorganize. Every subdirectory other than src/ now has a _ prefix. The content of src/ is moved into the root of website directory itself. 2018-08-28 03:57:51 +08:00			`%.html: %.md $(TOOL_BINARIES) $(TOOLS_DIR)/md-to-html`
			`$(TOOLS_DIR)/md-to-html $< $@`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00
website: Document the Makefile. 2018-06-06 04:38:39 +08:00			`# Generates the website into the dst directory.`
Vendor the genblog command. This simplifies the website toolchain to no longer depend on an external repository, and allows developing the genblog command in lockstep with the needs of the website. 2020-06-14 19:45:17 +08:00			`gen: tools $(HTMLS)`
website: Update the get page. * Add TOC. * Tweak the OS packages section a bit. * Unbreak the NEXT-RELEASE link by creating it as a symlink. Also remove an unnecessary "./" in Makefile. 2021-02-16 05:21:41 +08:00			`$(TOOLS_DIR)/genblog.bin . $(DST_DIR)`
website: Optimize fonts by embedding all fonts into a single CSS. Also substract the subset of glyphs that we need to reduce the size of the fonts. 2020-06-15 07:06:28 +08:00			ln -sf `pwd`/fonts.css `pwd`/favicons/* $(DST_DIR)/
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00
Move Go programs in website/_tools to cmd/website. They also live in separate directories now, so that unit tests can be added in future. 2019-12-26 19:28:48 +08:00			`tools:`
			`for tool in $(TOOLS); do \`
website: Restructure directory. * Remove the _ prefix from directories. * Move cmd/website -> website/cmd. 2020-06-14 20:56:58 +08:00			`go build -o $(TOOLS_DIR)/$$tool.bin ./cmd/$$tool; \`
Move Go programs in website/_tools to cmd/website. They also live in separate directories now, so that unit tests can be added in future. 2019-12-26 19:28:48 +08:00			`done`

website/Makefile: add genblog as a nop target to avoid breaking elves/up. 2020-06-14 20:43:37 +08:00			`genblog:`
			`: # a nop, kept for backward compatibility with elves/up`

Move Go programs in website/_tools to cmd/website. They also live in separate directories now, so that unit tests can be added in future. 2019-12-26 19:28:48 +08:00			`# Synchronizes the generated website into $(PUBLISH_DIR). The PUBLISH_DIR`
Fix typos found by codespell 2020-10-06 02:35:52 +08:00			`# environment variable can be overridden to a remote place to publish this online.`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00			`publish: gen`
website: Reorganize. Every subdirectory other than src/ now has a _ prefix. The content of src/ is moved into the root of website directory itself. 2018-08-28 03:57:51 +08:00			`rsync -aLv --delete ./_dst/ $(PUBLISH_DIR)/`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00
			`clean:`
Move Go programs in website/_tools to cmd/website. They also live in separate directories now, so that unit tests can be added in future. 2019-12-26 19:28:48 +08:00			`rm -f $(HTMLS) _tools/*.bin`
website: Reorganize. Every subdirectory other than src/ now has a _ prefix. The content of src/ is moved into the root of website directory itself. 2018-08-28 03:57:51 +08:00			`rm -rf $(DST_DIR)`
Move source code for the website into this repo. The website contains documentations. Merging these two repos makes them more discoverable, and encourages updating the code and doc at the same time. 2018-06-06 04:33:59 +08:00
website/Makefile: add genblog as a nop target to avoid breaking elves/up. 2020-06-14 20:43:37 +08:00			`.PHONY: default gen tools genblog publish clean`
website: Attempt to fix Makefile for GNU Make >= 4. GNU Make >= 4 seems to behave differently with regards to dependencies with slashes in them. In particular, the dependency on tools/* in the wildcard rule %.html: %.md tools/... does not seem to cause tools/... to be built correctly. Working around this by putting all tools in the root directory, with binaries ending in ".tool". 2018-06-13 05:58:16 +08:00			`.SECONDARY: $(TOOL_BINARIES)`