.. _tutorial2: ================================== Create a Cookiecutter From Scratch ================================== In this tutorial, we are creating `cookiecutter-website-simple`, a cookiecutter for generating simple, bare-bones websites. Step 1: Name Your Cookiecutter ------------------------------ Create the directory for your cookiecutter and cd into it: .. code-block:: bash $ mkdir cookiecutter-website-simple $ cd cookiecutter-website-simple/ Step 2: Create cookiecutter.json ---------------------------------- `cookiecutter.json` is a JSON file that contains fields which can be referenced in the cookiecutter template. For each, default value is defined and user will be prompted for input during cookiecutter execution. Only mandatory field is `project_slug` and it should comply with package naming conventions defined in `PEP8 Naming Conventions `_ . .. code-block:: json { "project_name": "Cookiecutter Website Simple", "project_slug": "{{ cookiecutter.project_name.lower().replace(' ', '_') }}", "author": "Anonymous" } Step 3: Create project_slug Directory --------------------------------------- Create a directory called `{{ cookiecutter.project_slug }}`. This value will be replaced with the repo name of projects that you generate from this cookiecutter. Step 4: Create index.html -------------------------- Inside of `{{ cookiecutter.project_slug }}`, create `index.html` with following content: .. code-block:: html {{ cookiecutter.project_name }}

by {{ cookiecutter.author }}

Step 5: Pack cookiecutter into ZIP ---------------------------------- There are many ways to run Cookiecutter templates, and they are described in details in `Usage chapter `_. In this tutorial we are going to ZIP cookiecutter and then run it for testing. By running following command `cookiecutter.zip` will get generated which can be used to run cookiecutter. Script will generate `cookiecutter.zip` ZIP file and echo full path to the file. .. code-block:: bash $ (SOURCE_DIR=$(basename $PWD) ZIP=cookiecutter.zip && # Set variables pushd .. && # Set parent directory as working directory zip -r $ZIP $SOURCE_DIR --exclude $SOURCE_DIR/$ZIP --quiet && # ZIP cookiecutter mv $ZIP $SOURCE_DIR/$ZIP && # Move ZIP to original directory popd && # Restore original work directory echo "Cookiecutter full path: $PWD/$ZIP") Step 6: Run cookiecutter ------------------------ Set your work directory to whatever directory you would like to run cookiecutter at. Use cookiecutter full path and run the following command: .. code-block:: bash $ cookiecutter You can expect similar output: .. code-block:: bash $ cookiecutter /Users/admin/cookiecutter-website-simple/cookiecutter.zip project_name [Cookiecutter Website Simple]: Test web project_slug [test_web]: author [Anonymous]: Cookiecutter Developer Resulting directory should be inside your work directory with a name that matches `project_slug` you defined. Inside that directory there should be `index.html` with generated source: .. code-block:: html Test web

Test web

by Cookiecutter Developer