Add missing copy function and add example

Makefile

@@ -14,6 +14,7 @@ endif
 PROJECT := Doorstop
 PACKAGE := doorstop
 SOURCES := Makefile setup.py $(shell find $(PACKAGE) -name '*.py')
+YAML := $(shell find . -name '*.yml' -not -path '*/test/files/*')
 EGG_INFO := $(subst -,_,$(PROJECT)).egg-info
 
 # System paths
@@ -74,7 +75,7 @@ ALL := $(ENV)/.all
 
 .PHONY: all
 all: depends $(ALL)
-$(ALL): $(SOURCES)
+$(ALL): $(SOURCES) $(YAML)
 	$(MAKE) doc pep8 pep257
 	touch $(ALL)  # flag to indicate all setup steps were successful
 
@@ -147,17 +148,17 @@ reqs: doorstop reqs-html reqs-md reqs-txt
 
 .PHONY: reqs-html
 reqs-html: env docs/gen/*.html
-docs/gen/*.html: $(shell find . -name '*.yml' -not -path '*/test/files/*')
+docs/gen/*.html: $(YAML)
 	$(BIN)/doorstop publish all docs/gen --html
 
 .PHONY: reqs-md
 reqs-md: env docs/gen/*.md
-docs/gen/*.md: $(shell find . -name '*.yml' -not -path '*/test/files/*')
+docs/gen/*.md: $(YAML)
 	$(BIN)/doorstop publish all docs/gen --markdown
 
 .PHONY: reqs-txt
 reqs-txt: env docs/gen/*.txt
-docs/gen/*.txt: $(shell find . -name '*.yml' -not -path '*/test/files/*')
+docs/gen/*.txt: $(YAML)
 	$(BIN)/doorstop publish all docs/gen --text
 
 .PHONY: uml

docs/reqs/REQ001.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.3
+level: 2.3
 links: []
 normative: true
 ref: ''

docs/reqs/REQ002.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.0
+level: 2.0
 links: []
 normative: false
 ref: ''

docs/reqs/REQ003.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.1
+level: 2.1
 links: []
 normative: true
 ref: ''

docs/reqs/REQ004.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.2
+level: 2.2
 links: []
 normative: true
 ref: ''

docs/reqs/REQ006.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 2.0
+level: 3.0
 links: []
 normative: false
 ref: ''

docs/reqs/REQ007.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 2.1
+level: 3.1
 links: []
 normative: true
 ref: ''

docs/reqs/REQ008.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 2.2
+level: 3.2
 links: []
 normative: true
 ref: ''

docs/reqs/REQ009.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 2.3
+level: 3.3
 links: []
 normative: true
 ref: ''

docs/reqs/REQ010.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.0
+level: 4.0
 links: []
 normative: false
 ref: ''

docs/reqs/REQ011.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.1
+level: 4.1
 links: []
 normative: true
 ref: ''

docs/reqs/REQ012.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.2
+level: 4.2
 links: []
 normative: true
 ref: ''

docs/reqs/REQ013.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.3
+level: 4.3
 links: []
 normative: true
 ref: ''

docs/reqs/REQ014.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.4
+level: 4.4
 links: []
 normative: true
 ref: ''

docs/reqs/REQ015.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 3.5
+level: 4.5
 links: []
 normative: true
 ref: ''

docs/reqs/REQ016.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.4
+level: 2.4
 links: []
 normative: true
 ref: ''

docs/reqs/REQ017.yml

@@ -1,6 +1,6 @@
 active: true
 derived: false
-level: 1.5
+level: 2.5
 links: []
 normative: true
 ref: ''

docs/reqs/REQ018.yml

@@ -0,0 +1,9 @@
+active: true
+derived: false
+level: 1.0
+links: []
+normative: false
+ref: ''
+reviewed: 36dc57d43cb60ffc9f05ffb055ac4994
+text: |
+  Overview

docs/reqs/REQ019.yml

@@ -0,0 +1,13 @@
+active: true
+derived: false
+level: 1.1
+links: []
+normative: false
+ref: ''
+reviewed: e6e5ef2698c5bbdf432abdd2f26d4bcf
+text: |
+  Doorstop is a requirements management tool that leverages version control to
+  store and manage a project's documentation traced from specification through
+  implementation.
+
+  ![Doorstop Logo](assets/logo-black-white.png "Doorstop Logo")

docs/reqs/assets/logo-black-white.png

@@ -0,0 +1 @@
+../../../pages/images/logo-black-white.png

doorstop/cli/test/test_all.py

@@ -16,7 +16,7 @@
 from doorstop.cli.test import SettingsTestCase
 
 REQ_COUNT = 14
-ALL_COUNT = 44
+ALL_COUNT = 46
 
 
 class TempTestCase(unittest.TestCase):

doorstop/common.py

@@ -2,6 +2,7 @@
 
 import os
 import shutil
+from distutils import dir_util
 import argparse
 import logging
 
@@ -178,6 +179,15 @@ def touch(path):  # pragma: no cover (integration test)
         write_text('', path)
 
 
+def copy(src, dst):
+    """Copy a file or directory."""
+    if os.path.isfile(src):
+        delete(dst)
+        shutil.copy(src, dst)
+    elif os.path.isdir(src):
+        dir_util.copy_tree(src, dst)
+
+
 def delete(path):  # pragma: no cover (integration test)
     """Delete a file or directory with error handling."""
     if os.path.isdir(path):

doorstop/core/publisher.py

@@ -54,7 +54,9 @@ def publish(obj, path, ext=None, linkify=None, index=None, **kwargs):
         lines = publish_lines(obj2, ext, linkify=linkify, **kwargs)
         common.write_lines(lines, path2)
         if obj2.assets:
-            common.copy(obj2.assets, os.path.join(path2, obj2.ASSETS))
+            src = obj2.assets
+            dst = os.path.join(os.path.dirname(path2), obj2.ASSETS)
+            common.copy(src, dst)
 
     # Create index
     if index and count: