golang.org/x/tools@v0.21.0/cmd/present/doc.go (about)

     1  // Copyright 2011 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  /*
     6  Present displays slide presentations and articles. It runs a web server that
     7  presents slide and article files from the current directory.
     8  
     9  It may be run as a stand-alone command or an App Engine app.
    10  
    11  To use with App Engine, copy the files in the tools/cmd/present directory to the
    12  root of your application and create an app.yaml file similar to this:
    13  
    14  	runtime: go111
    15  
    16  	handlers:
    17  	- url: /favicon.ico
    18  	  static_files: static/favicon.ico
    19  	  upload: static/favicon.ico
    20  	- url: /static
    21  	  static_dir: static
    22  	- url: /.*
    23  	  script: auto
    24  
    25  	# nobuild_files is a regexp that identifies which files to not build.  It
    26  	# is useful for embedding static assets like code snippets and preventing
    27  	# them from producing build errors for your project.
    28  	nobuild_files: [path regexp for talk materials]
    29  
    30  When running on App Engine, content will be served from the ./content/
    31  subdirectory.
    32  
    33  Present then can be tested in a local App Engine environment with
    34  
    35  	GAE_ENV=standard go run .
    36  
    37  And deployed using
    38  
    39  	gcloud app deploy
    40  
    41  Input files are named foo.extension, where "extension" defines the format of
    42  the generated output. The supported formats are:
    43  
    44  	.slide        // HTML5 slide presentation
    45  	.article      // article format, such as a blog post
    46  
    47  The present file format is documented by the present package:
    48  https://pkg.go.dev/golang.org/x/tools/present
    49  */
    50  package main