1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-04 23:39:57 +00:00
TiddlyWiki5/editions/dev/tiddlers/build/Scripts for building tiddlywiki.com.tid

94 lines
3.3 KiB
Plaintext
Raw Normal View History

2014-10-14 14:15:56 +00:00
title: Scripts for building tiddlywiki.com
2014-10-16 08:27:25 +00:00
These scripts are used to build and release the content for tiddlywiki.com. They are not designed for general purpose use -- they resolve problems that are specific to the task of building tiddlywiki.com: pushing to GitHub Pages, handling the prerelease builds and bumping version numbers.
Nonetheless, you may find techniques that are useful for your own scripts.
2014-10-14 14:15:56 +00:00
! Hosting
https://tiddlywiki.com is served by [[GitHub Pages|https://pages.github.com]] from the repository https://github.com/Jermolene/jermolene.github.io
2014-10-14 14:15:56 +00:00
The scripts live in the repository https://github.com/Jermolene/build.jermolene.github.io
! Directory structure
These scripts require the following directories to be siblings:
* `build.jermolene.github.io` - a local copy of https://github.com/Jermolene/build.jermolene.github.io
* `jermolene.github.io` - a local copy of the repo https://github.com/Jermolene/jermolene.github.io
2014-10-16 08:27:25 +00:00
* `TiddlyWiki5` - a local copy of the repo https://github.com/Jermolene/TiddlyWiki5
2014-10-14 14:15:56 +00:00
The scripts are designed to be executed with the current directory being the `TiddlyWiki5` directory.
! Configuration
!! package.json
The `package.json` in the root of the `build.jermolene.github.io` repository contains a dependency declaration that specifies the latest official released version of TiddlyWiki to be used when building the release targets:
2014-11-28 10:06:17 +00:00
```js
2014-10-14 14:15:56 +00:00
"dependencies": {
"tiddlywiki": "5.1.2"
}
```
!! Environment variables
Some of the scripts use the following environment variables:
* ''TW5_BUILD_MAIN_EDITION'' - the path to the wiki folder to be used as the main edition, generating `index.html` and `encrypted.html`
* ''TW5_BUILD_OUTPUT'' - the path to the output folder (defaults to `../jermolene.github.io`)
* ''TW5_BUILD_TIDDLYWIKI'' - the pathname of the `tiddlywiki.js` to be used (defaults to `../build.jermolene.github.io/node_modules/tiddlywiki/tiddlywiki.js`)
! Scripts
!! `bld.sh`
Builds the `tiddlywiki.com` target files. By default, it uses the version of tiddlywiki specified in the `package.json` file. This can be overridden with the ''TW5_BUILD_TIDDLYWIKI'' environment variable. The following command would select the latest prerelease version of tiddlywiki from the `TiddlyWiki5` directory:
2014-11-28 10:06:17 +00:00
```bash
2014-10-14 14:15:56 +00:00
TW5_BUILD_TIDDLYWIKI=./tiddlywiki.js
```
2014-10-16 08:27:25 +00:00
!! `readme-bld.sh`
Builds the readme files for the `TiddlyWiki5` and `build.jermolene.github.io` repos using the released version of TiddlyWiki specified in `package.json`.
2014-10-14 14:15:56 +00:00
!! `prerelease-bld.sh`
Builds the `tiddlywiki.com/prerelease` target files using the latest TiddlyWiki prerelease code and special ''prerelease'' edition for the content.
2014-10-15 18:46:11 +00:00
!! `github-push.sh`
2014-10-14 14:15:56 +00:00
Pushes the latest changes to the `jermolene.github.io` directory to GitHub.
2014-10-16 08:27:25 +00:00
!! `dev-bld.sh`
Builds the ''dev'' prerelease edition.
!! `quick-bld.sh`
Builds the ''prerelease'' prerelease edition.
!! `tiddlyspace-upload.sh`
Builds the ''tw5tiddlyweb'' edition and uploads it to TiddlySpace.
!! `verbump.sh`
Bumps the version number of the `package.json` in the `TiddlyWiki5` repo and applies the correct version tag to the repo.
!! `npm-publish.sh`
Publishes the `TiddlyWiki5` repo to npm.
2014-10-14 14:15:56 +00:00
! Procedures
!! Releasing a new version of TiddlyWiki
{{Releasing a new version of TiddlyWiki}}
!! Releasing new content for TiddlyWiki
{{Releasing new content for TiddlyWiki}}