Commit Graph

19 Commits

Author SHA1 Message Date
Kevin Putnam f6b6364490 Implements copy button (#1180)
* Adds support for sphinx_copybutton.

Closes #1134

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Additional config.

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* Remove cruft.;)

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>

* **DO NOT MERGE** Please verify changes with tutorials/proxy.rst. Once verified remove changes to proxy.rst.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Provides example usage of new codeblock copy behavior:

1. ShellSession (line 228 in kernel-modules-dkms.rst) - will copy everything except prompt.
2. Console (line 74 in kernel-modules-dkms.rst) - will copy only the input line without the prompt.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

Co-authored-by: Michael Vincerra <michael.vincerra@intel.com>
2020-06-02 11:21:34 -07:00
Kevin Putnam a6204a18cb Adds manpages to reference section of Clear Linux docs (#1110)
* Build manpages with "make man".

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adds "make man" to github workflows.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Remove shell script dependency.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Change git URLs to https.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved git clone to Makefile.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Fixed typo.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Adding pandoc install.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Moved to Makefile.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* First commit toward programmatic creation of manpages.rst

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Multiple updates:

1. man-pages.rst now generated by script.
2. Updated Makefile and make.bat with "man" and "clean-man" recipes.
3. Fixed typo in conf.py.
4. Many improvements to manpages.py

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>

* Updated readme for man pages and added man-pages.rst

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2020-05-01 12:23:21 -07:00
michael vincerra da2334e3ab In top Makefile, adds venv target to use virtualenv: (#741)
- Contributors may run `make venv` and install requirements.txt without modifying host OS
- Innermost `requirements.txt`, 2 dependencies, moved to uppermost requirements.txt
- Adds `venv` to .gitignore in case contributors/developer forget to remove.
- Reverts source/conf.py to original.
- Replaces python command with python3 in innermost _python/Makefile

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2019-09-22 21:06:08 -07:00
Kevin Putnam cc56d56ee9 * Master is now deploying only the latest tagged release of simplified Chinese into /source/_build/html/zh_CN.
* Both Chinese and English are built for error checking purposes only (parallel dirs /source/_build/html and /source/_build/zh_CN).
* Next stage will be to move building of simplified Chinese to https://github.com/clearlinux/clear-linux-documentation-zh-CN only and use latest release from that repo.

Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-09-09 13:36:27 -07:00
Kevin Putnam b8d2f88a67 Changed sphinx requirement to 1.8. Added error on warning to htmlall make rule.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-26 15:52:17 -07:00
Kevin Putnam 34711e6266 Added items to white list.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-24 11:11:21 -07:00
Kevin Putnam 83fea39d7c Removed German build as gitlab complained about too many artifacts.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-22 14:17:14 -07:00
Kevin Putnam e36c86ed7e Small change to theme and added build of Chinese language version.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-22 14:10:10 -07:00
Kevin Putnam e3329bc2ca Added german language support and build for travis
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-12 13:36:15 -07:00
Kevin Putnam ba9fd8f0a7 Added auto bundle update and turned off linkcheck for now.
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 15:07:38 -07:00
Kevin Putnam f89f43e06f Fixed path for calling linkcheck in Makefile
Signed-off-by: Kevin Putnam <kevin.putnam@intel.com>
2019-07-11 12:26:34 -07:00
Michael Vincerra 4e2240fb43 Merge branch 'master' into makefile-mod 2019-01-31 13:59:53 -08:00
Kevin Putnam a3c1c5b9c3 moved linkcheck helper script to sub-directory 2018-12-28 10:02:54 -08:00
Kevin Putnam a80b1f5727 removed unnecessary @echo in Makefile 2018-12-26 11:52:31 -08:00
Kevin Putnam 44978b744d added whitelist and parse script. changed Makefile 2018-12-18 11:37:46 -08:00
Michael Vincerra 324a7dc6a2 Modifies source/Makefile in order to:
- Adds new 'py' directive with Bash script
- Adds same Bash script under json directive
- Invoke child Makefile in /scripts/_python
- Execute bundle_lister.py
- Provide 'py' directive for future Python scripts

Signed-off-by: Michael Vincerra <michael.vincerra@intel.com>
2018-12-15 18:57:37 -08:00
Rodrigo Caballero 41cdf6ab0d Revert "Merge branch 'new-file-struct' into 'master'"
This reverts commit 4d707bc539, reversing
changes made to b18458758e.

Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-11-22 10:56:24 -06:00
Rodrigo Caballero a4b61aecf9 Modify file structure of docs source files.
Changed the file structure to allow for easier and better maintenance of
the docs. Files were renamed as needed and following a consistent
convention. Added a index.rst to every folder allowing for partial
builds of the docs. Included content previously left out of the docs
build. The commit also performs minimal housekeeping.

Signed-off-by: Rodrigo Caballero <rodrigo.caballero.abraham@intel.com>
2016-11-18 13:36:22 -06:00
Leona 5f15301376 images need to be in _static folder for linkage, updating index with files, syntax editing on message broker service 2015-11-16 08:34:26 -08:00