You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Mary Anthony 9fe961c7d6 Testing the iOS tutorial 5 years ago
_android moxiegirl > meepers 5 years ago
_browser Testing the iOS tutorial 5 years ago
_common Removing outdated file 5 years ago
_community Fixes #422 remove product hunt references 5 years ago
_core Merge pull request #437 from blockstack/lgalabru-patch-1 5 years ago
_data Fixed typo 5 years ago
_develop Fixed typo. 5 years ago
_faqs Updating forward looking statements in docs 5 years ago
_includes Updating to add Edit Me 5 years ago
_ios Testing the iOS tutorial 5 years ago
_layouts Initial Smart Contract Docs 6 years ago
_org Updating forward looking statements 5 years ago
_plugins WIP 6 years ago
_posts Updating 6 years ago
_sass - Updating with the newest UX language 6 years ago
_storage moxiegirl > meepers 5 years ago
assets Fixing jump to internal anchors 5 years ago
exclude WIP 6 years ago
news Initial commits 6 years ago
.gitignore Security alert fixes (#126) 6 years ago
404.md Update all 6 years ago
Gemfile Adding Google Tag Manager 6 years ago
Gemfile.lock Adding Google Tag Manager 6 years ago
Guardfile Adding in changes for token site 6 years ago
README.md Updating the readme 5 years ago
THEME_README.md [REVIEW] Gaia move to docs.blockstack (#111) 6 years ago
_config.yml Updating to add Edit Me 5 years ago
_redirects Updating for redirect 6 years ago
blockstack-icon.png Testing the iOS tutorial 5 years ago
changelog.md Initial commits 6 years ago
collections.json WIP 6 years ago
contact.md Some typos caught by Pat Murphy (#202) 6 years ago
get-content.sh Working on build infrastructure 6 years ago
history.png Adding in changes for token site 6 years ago
index.md staticman' 6 years ago
overview_auth.md Fixing Blockstack browser > Blockstack Browser 6 years ago
package-lock.json Closes #320, #321 5 years ago
package.json Security alert fixes (#126) 6 years ago
robots.txt Fix for twitter cards (#34) 6 years ago
staticman.yml Updating with latest 6 years ago
thanks.md Initial commits 6 years ago

README.md

README for the documentation site

Building after a fork

Run locally

To run locally:

  1. Get the content from the downstream repos.

    ./get-content.sh
    
  2. Build and serve locally.

    bundle exec jekyll serve --config _config.yml,staticman.yml
    

    Use this format to turn on production features:

    JEKYLL_ENV=production bundle exec jekyll serve --config _config.yml
    

Deploy via Netlify

To deploy to Netlify:

  1. Build the site.

    JEKYLL_ENV=production bundle exec jekyll build --config _config.yml
    
  2. Force add the _site directory.

    git push -f origin
    

Test a Deploy with Surge

cd _site
surge
surge --domain raspy-songs.surge.sh

To generate the CLI json manually

The _data/cliRef.json file is generated from the blockstack-cli subcommand docs. This data file is consumed by the _includes/commandline.md file which is used to serve up the reference.

  1. Install the latest version of the cli according to the instructions at: https://github.com/blockstack/cli-blockstack

  2. Generate the json for the cli in the docs.blockstack repo.

    $ blockstack-cli docs | python -m json.tool > _data/cliRef.json 
    
  3. Make sure the generated docs are clean by building the documentation.

    If you run into any problem in the generation usually it results from a problem in the repo. You can make a pull request back to the repo to fix anything.

Clarity Reference

As of 8/12/19 Clarity is in the develop branch of core. You can build the Clarity command line from the Docker image. core/src/vm/docs/mod.rs

  1. Pull the latest developer preview from the Docker Hub.

    $ docker pull blockstack/blockstack-core:clarity-developer-preview
    
  2. Build the lastest JSON.

    docker run -it blockstack/blockstack-core:clarity-developer-preview blockstack-core docgen | jsonpp > ~/repos/docs.blockstack/_data/clarityRef.json
    
  3. Build the documentation and verify the Clarity reference is building correctly.

  4. Make changes in core

  5. Build the docker image

  6. Run doc gen with the new image

   $ docker run --name docsbuild -it blockstack-test blockstack-core docgen | jsonpp > ~/repos/docs.blockstack/_data/clarityRef.json

Technology Reference