go-sylixos/elvish
3
0
Fork 0
mirror of https://github.com/go-sylixos/elvish.git synced 2024-12-01 00:33:05 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
1da19a0b03
elvish/website/Makefile

48 lines
1.3 KiB
Makefile
Raw Normal View History

Remove navbar and hide ToC in docset files. This is implemented by using an environment variable ELVISH_DOCSET_MODE to control the template.
2021-06-13 08:46:27 +08:00
DST_DIR := ./_dst
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
PUBLISH_DIR := ./_publish
Remove navbar and hide ToC in docset files. This is implemented by using an environment variable ELVISH_DOCSET_MODE to control the template.
2021-06-13 08:46:27 +08:00
DOCSET_TMP_DIR := ./_docset_tmp
DOCSET_DST_DIR := ./Elvish.docset
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
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
MD_TO_HTML_TOOLS = $(addprefix tools/,$(shell grep -o '\w*\.bin' tools/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: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
# Generates the website into $(DST_DIR).
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
gen: tools/gensite.bin $(HTMLS)
website: Rename the "genblog" tool to "gensite". Also rename internal references to the "blog" to "site" when it refers to the site as the whole (instead of https://elv.sh/blog).
2022-01-01 20:06:27 +08:00
tools/gensite.bin . $(DST_DIR)
website: Serve fonts as individual files. Upsides: - Removing the render-blocking fonts.css allows the page to be visible while the font is being loaded. - The original WOFF2 files are smaller than the base64-encoded version in fonts.css. - Browsers may be smart enough to not download fonts that are not needed. The only downside is that this requires the browser to make more requests - up to 6 for all 6 font files. But this is not a problem with modern browsers.
2021-11-11 07:43:44 +08:00
ln -sf `pwd`/fonts `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
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
# Generates docset into $(DOCSET_DST_DIR).
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
docset: tools/gensite.bin $(HTMLS)
website: Rename the "genblog" tool to "gensite". Also rename internal references to the "blog" to "site" when it refers to the site as the whole (instead of https://elv.sh/blog).
2022-01-01 20:06:27 +08:00
ELVISH_DOCSET_MODE=1 tools/gensite.bin . $(DOCSET_TMP_DIR)
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
tools/mkdocset $(DOCSET_TMP_DIR) $(DOCSET_DST_DIR)
Remove navbar and hide ToC in docset files. This is implemented by using an environment variable ELVISH_DOCSET_MODE to control the template.
2021-06-13 08:46:27 +08:00
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
# Synchronizes the generated website into $(PUBLISH_DIR), which is passed to
# rsync and can be a remote place.
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
website: Add Python script to check relative links.
2021-11-30 03:21:51 +08:00
check-rellinks: gen
python3 tools/check-rellinks.py $(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
clean:
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
rm -rf tools/*.bin $(HTMLS) $(DST_DIR) $(DOCSET_TMP_DIR) $(DOCSET_DST_DIR)
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
website: Move ttyshot generation rules to ttyshot/Makefile. Ttyshots are committed into the repo, and should not be regenerated during a normal website building process.
2022-08-01 05:18:59 +08:00
ttyshot/%.html:
@echo Exclude ttyshots from the pattern rule for %.html
website/Makefile: add @ttyshot dependencies. Also rename the ref-deps script to extra-deps now that its scope is a bit larger.
2021-12-28 21:13:27 +08:00
website: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
.PHONY: gen docset publish check-rellinks clean
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
website/Makefile: Prevent removal of intermediate targets.
2022-01-04 01:54:06 +08:00
# Don't remove intermediate targets
.SECONDARY:
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
.SECONDEXPANSION:
website: Make tool binary depend on every file in source dir. With the use of go:embed, non-Go files can affect the tools too.
2022-08-01 04:55:47 +08:00
tools/%.bin: cmd/% $$(wildcard cmd/%/*)
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
go build -o $@ ./$<
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: Make the tool dependency for %.html more accurate. Only depend on the tools referenced by tools/md-to-html. This uses "grep -o", which is not part of POSIX but is supported by both GNU and BSD greps, so widely enough.
2022-01-01 23:26:01 +08:00
%.html: %.md tools/md-to-html $(MD_TO_HTML_TOOLS) $$(shell tools/extra-deps $$@)
website: Rewrite Makefile. * Reorder the targets to be top-down * Make the tool binaries individual real targets, rather than a phony target * Use .SECONDEXPANSION to determine dependencies of tool binaries and HTML outputs precisely
2021-11-29 22:08:05 +08:00
tools/md-to-html $< $@
Reference in New Issue Copy Permalink