QuicWebbUpdater

Getting Started • Original Setup • Resources

Getting Started ▴

Prerequisites

• Install Xcode 10 ⇗
• Install homebrew ⇗
• Install vapor toolbox ⇗

Download|Clone & Run

Steps to download repository:

## go to your working directory
cd <your-choosen-directory-path>

## download and unzip
wget https://github.com/VaporExamplesLab/QuicWebbUpdater/archive/master.zip
unzip master.zip -d QuicWebbUpdater
rm master.zip     # remove download

cd QuicWebbUpdater-master

# update dependencies 
# with `-y` yes to generate and open Xcode project
vapor update -y

Or, alternate steps to clone repository instead of download:

## go to your working directory
cd <your-choosen-directory-path>

## either clone
##    add --bare option for an unattached instance
git clone [email protected]:VaporExamplesLab/QuicWebbUpdater.git 

cd QuicWebbUpdater

# update dependencies 
# with `-y` yes to generate and open Xcode project
vapor update -y

Directory Structure

blog_content_original/
  html/
  # markdown/…/*.md pages map to blog_content_processed/leaf/_m/…/*.leaf
  # markdown/…/*_files/*  map to blog_content_processed/public/_m/…/*.leaf
  markdown/   
    yyyy/
      MM/
        article_files
        article.md
  paprika/
#
blog_content_processed/
  leaf/
    _h/
    _m/
      yyyy/
        mm/
          article.leaf
    _r/
  public/
    _h/
    _m/
      yyyy/
        mm/
          article_files/*
    _r/

QuicWebbUpdater/
  Public/   # must match URL for relative addressing
     _h → blog_content_processed/public/_h
     _m → blog_content_processed/public/_m
     _r → blog_content_processed/public/_r
  Resources/
    Views/  # path to leaf can be revised by router ?
      _h → blog_content_processed/leaf/_h
      _m → blog_content_processed/leaf/_m
      _r → blog_content_processed/leaf/_r

route

leaf template

cd QuicWebbUpdater
ln -s ../../blog_content_processed/public/_h Public/_h 
ls -l Public/_h/
ln -s ../../blog_content_processed/public/_m Public/_m 
ls -l Public/_m/
ln -s ../../blog_content_processed/public/_r Public/_r 
ls -l Public/_r/
ls -l Public

ln -s ../../../blog_content_processed/leaf/_h Resources/Views/_h 
ls -l Resources/Views/_h/
ln -s ../../../blog_content_processed/leaf/_m Resources/Views/_m 
ls -l Resources/Views/_m/
ln -s ../../../blog_content_processed/leaf/_r Resources/Views/_r 
ls -l Resources/Views/_r/
ls -l Resources/Views

Set Xcode scheme to "Run > My Mac".

Click the run button and check the results in a browser at http://localhost:8080.

Original Setup ▴

The following steps were completed to create the QuicWebbUpdater example.

Create Vapor Website Project

Create a QuicWebbUpdater project from the command line terminal:

vapor new QuicWebbUpdater --web
cd QuicWebbUpdater
# add directory for README.md assets
mkdir README_files 
touch README_files/.git_keep # create file so folder is not empty for `git`  

# update dependencies 
# with `-y` yes to generate and open Xcode project
vapor update -y

Resources ▴

• Bootstrap ⇗