Detailed documentation on the complete lifecycle of a TACC ACI-WMA Core v2 Portal.
Core Portal Lifecycle Procedures
To serve the file locally, we recommend using Docker Desktop and the containerized markdown server Madness.
- Ensure Docker Desktop is installed and running.
- Ensure Madness is aliased and working:
> alias madness='docker run --rm -it -v $PWD:/docs -p 3000:3000 dannyben/madness'
- Open a command prompt and navigate to the root folder of the markdown you want to serve (i.e. -
> cd /Users/<user_name>/code/markdown_src
). - Start madness:
> madness
- Open your browser to
0.0.0.0:3000
(the default port for madness). - View your live markdown.
Note: Madness does not have a live reload feature. You will need to refresh your browser to see saved changes render on-screen.