{"id":22915051,"url":"https://github.com/stratisproject/documentation","last_synced_at":"2025-05-12T13:45:09.230Z","repository":{"id":35600148,"uuid":"137256979","full_name":"stratisproject/Documentation","owner":"stratisproject","description":"This repository contains the source of the Stratis Academy","archived":false,"fork":false,"pushed_at":"2023-09-22T21:47:23.000Z","size":38461,"stargazers_count":7,"open_issues_count":2,"forks_count":18,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-03-31T22:41:27.314Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://academy.stratisplatform.com","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stratisproject.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-06-13T18:44:21.000Z","updated_at":"2021-12-24T12:01:23.000Z","dependencies_parsed_at":"2022-07-24T18:32:22.551Z","dependency_job_id":null,"html_url":"https://github.com/stratisproject/Documentation","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FDocumentation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FDocumentation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FDocumentation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stratisproject%2FDocumentation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stratisproject","download_url":"https://codeload.github.com/stratisproject/Documentation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253749873,"owners_count":21958204,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-14T05:18:28.602Z","updated_at":"2025-05-12T13:45:09.175Z","avatar_url":"https://github.com/stratisproject.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Documentation\n\n## RST Resources\n\nRST files have an *.rst extension, and GitHub does a great job of rendering them. They use a markup that means the source file is very readable. Look at one of the RST files in the source directory. Click the *Raw* button to view the VST file. \n\nThe links will help get you up to speed with editing RST files:  \n\n[RST (and Sphinx) CheatSheat](https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html#internal-and-external-links)\n\n[RST Primer](http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html)\n\n## Installing Sphinx \n\nIf you are writing a new article for the academy or doing a heavy edit involving adding links etc., it is best to clone this repository and build and test the updated version of the Stratis Academy locally.\n### For macOS and GNU/Linux\n\n1. Python must be installed. Currenly, macOS seems to be shipping with version 2.7, but to build documentation you need Python \u003e= 3.7. New Python's versions are avilable on [the official downloads page](https://www.python.org/downloads/).\n2. Make sure you have `pip` (which is a package management system for Python) installed on your computer. If you don't have `pip`, look for [the official installation guide](https://pip.pypa.io/en/stable/installing/).\n3. (_Optional_) To avoid situation called _Python's Dependency hell_, we are strongly recommend you to use _virtual environment_. Create virtual environment by entering the following: `python -m venv /path/to/env`, where `/path/to/env` is the path where you want to create your environment. Then, you need to activate your environment by entering the following: `source /path/to/env/bin/activate`. Now, all of dependencies you'll install will belong to your virtual environment and not to global Python installation.\n4. Clone this Documentation repository after first creating a folder in which hold the clone. You will see why in the next step.\n5. Go to the cloned Documentation directory and install Sphinx and other required dependencies by entering the following: `pip install -r requirements.txt`.\n6. (_If you are **NOT** using virtual environment_) The sphinx-build command is now in `$HOME/Library/Python/3.7/bin`. If you are using the up-to-date version of python, the version number will be different. It is best to add this path to the \\$PATH enviromental variable. To do this, add the follwing line: `export PATH=\"$HOME/Library/Python/3.7/bin:$PATH\"` to your `$HOME/.bash_profile` file. Note that this file is hidden.\n7. In the \"root\" of the Documentation repository, enter `make html`. You should see something like this:![](building_academy.png) The output be in a `build` directory at the same level as your Documentation repository. The `build` directory position is to stop the output getting mixed up with the source.\n8. In your browser, now open `build/html/index.html` using the file protocol. From here, you should be able to navigate around your updated version of the academy.\n9. When you are happy with your updates, submit a pull request.\n\n#### A quick way to run a local host\n\nAs an alternative to using the file protocol to view the academy, Python provides a quick way to run a local Http Server. Start a bash shell (terminal) and navigate to `build/html` from within the folder you created to hold the Documentation repository clone.\n\nTo run a local host, enter:\n\n`python -m http.server`\n\n![](local_Http_server.png)Navigate to  [http://localhost:8000](http://localhost:8000/) and you should see the your updated version of the academy.\n\n### For Windows\n\nAlmost all the steps are identical to corresponding steps in macOS and GNU/Linux instruction. However, some steps are slighly different:\n- To build this documentation, you need MSVC++ Build Tools to be installed on your PC. For more information, check out [the VS tools download page](https://visualstudio.microsoft.com/ru/downloads/).\n- To install Sphinx and other required dependencies in Windows machine, go to the cloned Documentation directory and execute following command.\n`py -m pip install -r requirements.txt`\n- (_If you are **NOT** using virtual environment_) On Windows, Python may be installed on path: `C:\\Users\\\u003cusername\u003e\\AppData\\Local\\Programs\\Python\\Python37\\bin`, and additional packages may be installed on `C:\\Users\\\u003cusername\u003e\\AppData\\Roaming\\Python\\Lib`.\n- (_If you are **NOT** using virtual environment_) Keep in mind that PATH environmental variables are added in different way on Windows than on *nix systems. If you need help, check out [this instruction](https://java.com/en/download/help/path.html).\n- Instead of using `make html` command, you should use `make.bat html`.\n\n## Ideas for new articles\n\nThe pages listed here contain ideas for articles for each category. Currently, the plan is add more articles on the full node, and the ideas for this so far are listed here:\n\n[Full Node](Full_Node_Document_Ideas.md)\n\nThis will give the full node category a \"cookbook\" type approach, which I think will work well under the current circumstances. I am thinking that when you look down the full node contents, you will see engaging questions like \"How do you interpret the full node output?\" Please feel free to add more ideas to the list (and start another list for smart contracts etc.).\n\n## Internal links\nRegarding links, Sphinx can be a a bit cryptic on the subject of internal links. If offers a number of options but, at least on the subject of anchors, I had to dig around for info:\n\n###Link to a header in the same file and use the header text\n\nTake the following header:\n\nMy header\n=========\n\nIf you are OK with the link text being the same as the header text: \n\nThis is how to link to `My header`_.\n\n\n###Link to something other than a header in the same file\n\nThe next thing you might want to do is create an link to an image, code example etc. The text in the link could be anything. To do this, create a label above the image or whatever to create an anchor:\n\n.. _some_figure:\n\n.. image:: stars.jpg\n    :width: 200px\n    :align: center\n    :height: 100px\n    :alt: alternate text\n\nThen link like this:\n\nPlease refer to the :ref:`previous figure \u003csome_figure\u003e`. \n\nRemember to always leave a gap on one line between the label and what you want to link to; otherwise you get a warning.\n\n###Link to a header in the same file but don't use the header text\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Fdocumentation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstratisproject%2Fdocumentation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstratisproject%2Fdocumentation/lists"}