Skip to content
Snippets Groups Projects
README.md 2.17 KiB
Newer Older
pretoms's avatar
pretoms committed
# dpp_docs
A new template for the Design for Physical Prototyping project documentation. 
pretoms's avatar
pretoms committed
It uses the static site generator [Hugo](https://gohugo.io/) to generate a web pages from Markdown files with the [Hugo Book Theme](https://github.com/alex-shpak/hugo-book) and the theme component [hugo-video](https://github.com/martignoni/hugo-video).
pretoms's avatar
pretoms committed

pretoms's avatar
pretoms committed
To get started with your documentation, generate your own repository by clicking "[use this template]" or clone this repository.
pretoms's avatar
pretoms committed
Using GitHub pages you can access your documentation via [https://YOUR-GITHUB-USERNAME.github.io/YOUR-REPO-NAME](https://pretoms.github.io/dpp_docs/).
pretoms's avatar
pretoms committed

pretoms's avatar
pretoms committed
# Quickstart

For working on your documentation it is recommended to host your local Hugo instance and to use a text editor of your choice to edit the Markdown files. 

First install Hugo.
## Windows
pretoms's avatar
pretoms committed
Use PowerShell to install the extended version of Hugo with winget. Add <kbd>%localappdata%\microsoft\winget\packages</kbd> to your [path variable](https://windowsloop.com/how-to-add-to-windows-path/).
pretoms's avatar
pretoms committed
```bash
winget install Hugo.Hugo.Extended
```

## Linux
```bash
sudo apt install hugo
```

## Mac OS
Install Hugo using the free and open source package manager [Homebrew](https://brew.sh/). This will install the extended edition of Hugo.

```bash
brew install hugo
```

# Clone

Make sure you have [Git](https://git-scm.com/) installed on your system.
pretoms's avatar
pretoms committed
Clone your repository to your system.
pretoms's avatar
pretoms committed
Change active directory to the cloned repository and run the Hugo server.

```bash
pretoms's avatar
pretoms committed
git clone <your-repo> <target-directory>
pretoms's avatar
pretoms committed
cd C:\your\local\repository\path
hugo server --minify
```

pretoms's avatar
pretoms committed
## Replace the content of the template pages

Update the following files to your own content:

pretoms's avatar
pretoms committed
* rename project folder <kbd>content/docs/projects/our_project</kbd> to the title of your project and remove all files but <kbd>_index.md</kbd>.
* <kbd>README.md</kbd> (information for those who access your repository site on GitHub: replace it with your text or just delete content and leave it empty)
pretoms's avatar
pretoms committed

Put all images, videos and GIFs you want to embed in your documentation into the assets folder.

pretoms's avatar
pretoms committed
Then visit http://localhost:1313 to view the documentation.

pretoms's avatar
pretoms committed
[use this template]: https://github.com/pretoms/dpp_docs/generate