Skip to content
Trivadis PL/SQL & SQL Coding Guidelines
Shell HTML Dockerfile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
custom-theme
docker Update versions incude fix for mike's set-default Sep 21, 2019
docs fixes #76 - tiltle of Urban Lankes Sep 28, 2019
tools fixes #74 - dead links to G-2150 and coding-style Sep 21, 2019
.gitignore
LICENSE.txt
README.md recommend Git for Windows (remove noisy link) Sep 28, 2019
mkdocs.yml

README.md

Trivadis PL/SQL & SQL Coding Guidelines

Introduction

Trivadis published their guidelines for PL/SQL & SQL in 2009 in the context of the DOAG conference in Nuremberg. Since then these guidelines have been continuously extended and improved. Now they are managed as a set of markdown files. This makes the guidelines more adaptable for individual application needs and simplifies the continous improvement.

HTML format

HTML is the primary output format. Material for MkDocs is used to generate static HTML files and Mike to publish version specific variants. The following sites are available:

PDF format

PDF is the secondary output format. wkhtmltopdf is used to produce it.

Starting with version 3.5 you may access the PDF document from the appendix in the HTML site.

The PDF version is also accessible per version from Releases.

Releases

You find all releases and release information here.

Issues

Please file your bug reports, enhancement requests, questions and other support requests within Github's issue tracker.

How to Contribute

  1. Describe your idea by submitting an issue
  2. Fork this respository
  3. Create a branch, commit and publish your changes and enhancements
  4. Create a pull request

How to Build the HTML Site

  1. Install Docker in your environment
  2. Fork this respository
  3. For Windows users only
    • Install Git for Windows, it provides Git command line tools, a GUI and a Bash emulator
  4. Check/change the version in mkdocs.yml
  5. Open a terminal window in the tools folder
    • Build/update the PDF file run ./genpdf.sh.
    • Test the HTML site locally run ./serve.sh and open http://localhost:8000
    • Deploy HTML site run ./mike.sh deploy master.
    • Set default version (HTML redirect) run ./mike.sh set-default master.
  6. commit changes and push all branches.

Related Resources

License

The Trivadis PL/SQL & SQL Coding Guidelines are licensed under the Apache License, Version 2.0. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

You can’t perform that action at this time.