| リビジョン | 986606706b754f07a955897126ee5860bb2177bf (tree) |
|---|---|
| 日時 | 2017-11-20 00:25:18 |
| 作者 | Albert Mietus < albert AT mietus DOT nl > |
| コミッター | Albert Mietus < albert AT mietus DOT nl > |
Updated style: use RTfD + additions (BUSY)
Makefile (diff) README.rst (diff)
_external_templates/conf/std_conf.py (diff) conf.py (diff) _external_templates/static/SwBMnl+rtfd.css (diff) _external_templates/conf/SwBMnl_theme.py _external_templates/static/SwBMnl-sphinx.css| @@ -47,3 +47,16 @@ | ||
| 47 | 47 | |
| 48 | 48 | run_pytests:: |
| 49 | 49 | -(cd pyMESS/training/dPID/; pytest) |
| 50 | + | |
| 51 | +HOGSMEADEd = /Volumes/albert/Sites/MESS/ | |
| 52 | + | |
| 53 | +Hogsmeade_check: # Is `~albert` on Hogsmeade mounted? | |
| 54 | + @echo -n Checking ${HOGSMEADEd} ... | |
| 55 | + @[ -d ${HOGSMEADEd} ] | |
| 56 | + @echo ok | |
| 57 | + | |
| 58 | +Hogsmeade: Hogsmeade_check | |
| 59 | + ${MAKE} OUTd=${HOGSMEADEd} | |
| 60 | + | |
| 61 | +Hogsmeade-clean: Hogsmeade_check | |
| 62 | + ${MAKE} OUTd=${HOGSMEADEd} cleanest |
| @@ -1,8 +1,6 @@ | ||
| 1 | 1 | .. Copyright (C) ALbert Mietus, SoftwareBeterMaken.nl; 2017. |
| 2 | 2 | Part of my `MESS` project |
| 3 | 3 | |
| 4 | - | |
| 5 | - | |
| 6 | 4 | ****** |
| 7 | 5 | ReadMe |
| 8 | 6 | ****** |
| @@ -16,6 +14,19 @@ | ||
| 16 | 14 | |
| 17 | 15 | .. glossary:: |
| 18 | 16 | |
| 17 | + Modern Engineering | |
| 18 | + | |
| 19 | + Software-engineering is a juvenile profession, with many new insights. | |
| 20 | + | |
| 21 | + Most are recently *discovered* in generic software development; like ‘the web’. And written | |
| 22 | + in a language (both computer and human), that is very contrasting with the technology-talk of | |
| 23 | + typical “RealTime/Embedded” engineering. And so, often rejected or not seen as relevant. | |
| 24 | + | |
| 25 | + Although their examples are too dissimular in many casses, the concepts can be useful. There is | |
| 26 | + no valid reason not to incorporate their modern approach of software-engineering into *our* | |
| 27 | + process. | |
| 28 | + | |
| 29 | + | |
| 19 | 30 | Sovereign Software |
| 20 | 31 | All **unmanaged**, *background* software enabling modern life! |
| 21 | 32 |
| @@ -33,18 +44,6 @@ | ||
| 33 | 44 | bug in a compiler will effect all end-users!). |
| 34 | 45 | |
| 35 | 46 | |
| 36 | - Modern Engineering | |
| 37 | - | |
| 38 | - Software-engineering is a juvenile profession, with many new insights. | |
| 39 | - | |
| 40 | - Most are recently *discovered* in generic software development; like ‘the web’. And written | |
| 41 | - in a language (both computer and human), that is very contrasting with the technology-talk of | |
| 42 | - typical “RealTime/Embedded” engineering. And so, often rejected, or not seen as relevant. | |
| 43 | - | |
| 44 | - Although their examples are too dissimular in many casses, the concepts can be useful. There is | |
| 45 | - no valid reason not to incorporate their modern approach of software-engineering into *our* | |
| 46 | - process. | |
| 47 | - | |
| 48 | 47 | .. MARKER_2 |
| 49 | 48 | |
| 50 | 49 | Copyright |
| @@ -55,17 +54,29 @@ | ||
| 55 | 54 | * Read & study them |
| 56 | 55 | * Use the ideas to improve your skills |
| 57 | 56 | |
| 58 | -Please use the *disqus* sections to give your feedback and opinions. | |
| 57 | +Please use the *disqus* sections (below) to give your feedback and opinions. | |
| 59 | 58 | |
| 60 | 59 | |
| 61 | 60 | --Albert Mietus |
| 62 | 61 | |
| 63 | 62 | .. MARKER_3 |
| 64 | 63 | |
| 65 | -(other) Modern Engineering | |
| 64 | +Tensegrity, as inspiration | |
| 66 | 65 | ************************** |
| 67 | 66 | .. image:: /_external_templates/static/Needle_Tower_doorzichtig.png |
| 68 | 67 | |
| 68 | +`Tensegrity <https://en.wikipedia.org/wiki/Tensegrity>`__ is a synthesis of the names ‘tensional’ | |
| 69 | +and ‘integrity’. It is based on *“teamwork”* of tension and compression forces. Although the image | |
| 70 | +may look confusing, these structures are really very simple. All you need are some poles, some | |
| 71 | +cable and good engineering. This can result is a beautiful ‘tensegrity-tower’ where the poles | |
| 72 | +almost float in air; as shown `above <https://commons.wikimedia.org/wiki/File:Kenneth_Snelson_Needle_Tower.JPG>`__ | |
| 73 | + | |
| 74 | +It is also a well-known architectural principle for skyscrapers! | |
| 75 | + | |
| 76 | +For me, it is also a inspiration for Software-Engineering: It should be based of teamwork: a synthesis | |
| 77 | +of creative and verifying people. Together with a methodical way-of-working the amplify each | |
| 78 | +other. Then, the sky becomes a limit, which is easy! | |
| 79 | + | |
| 69 | 80 | .. MARKER_4 |
| 70 | 81 | |
| 71 | 82 |
| @@ -1,52 +0,0 @@ | ||
| 1 | -# Copyright (C) ALbert Mietus, SoftwareBeterMaken.nl; 2011-2013, 2015, 2017 | |
| 2 | -# SwBMnl theme configuration | |
| 3 | -# -*- coding: utf-8 -*- | |
| 4 | - | |
| 5 | -## | |
| 6 | -## Use SwBMnl colors/fonts | |
| 7 | -## | |
| 8 | -_SwBMnl_BLAUW = '#000066' | |
| 9 | -_SwBMnl_LBLAUW = '#eeeeff' | |
| 10 | -_SwBMnl_ROOD = '#cc3333' | |
| 11 | -_SwBMnl_LTROOD = '#ffcccc' | |
| 12 | -_SwBMnl_SILVER = '#c0c0c0' | |
| 13 | -_SwBMnl_GRAY = '#808080' | |
| 14 | -_SwBMnl_Black = '#000000' | |
| 15 | -_SwBMnl_White = '#ffffff' | |
| 16 | - | |
| 17 | -html_theme_options = { | |
| 18 | - ## Options | |
| 19 | - 'collapsiblesidebar' : True, | |
| 20 | - 'externalrefs' : True, | |
| 21 | - 'stickysidebar' : True, | |
| 22 | - | |
| 23 | - ## fonts # (CSS font-family): | |
| 24 | - 'bodyfont' : '"Georgia", "Times New Roman", "Times"', | |
| 25 | - 'headfont' : '"Georgia", "Times New Roman", "Times"', | |
| 26 | - | |
| 27 | - ## Color's (CSS color) | |
| 28 | - 'bgcolor' : _SwBMnl_LBLAUW, # Body background color. | |
| 29 | - 'textcolor' : _SwBMnl_Black, # Body text color. | |
| 30 | - 'linkcolor' : _SwBMnl_BLAUW, # Body link color. | |
| 31 | - 'visitedlinkcolor' : _SwBMnl_BLAUW, # Body color for visited links. | |
| 32 | - | |
| 33 | - 'headbgcolor' : _SwBMnl_LBLAUW, # Background color for headings. | |
| 34 | - 'headtextcolor' : _SwBMnl_BLAUW, # Text color for headings. | |
| 35 | - 'headlinkcolor' : _SwBMnl_BLAUW, # Link color for headings. | |
| 36 | - | |
| 37 | - 'sidebarbgcolor' : _SwBMnl_BLAUW, # Background color for the sidebar. | |
| 38 | - 'sidebartextcolor' : _SwBMnl_White, # Text color for the sidebar. | |
| 39 | - 'sidebarlinkcolor' : _SwBMnl_LBLAUW, # Link color for the sidebar. | |
| 40 | - 'sidebarbtncolor' : _SwBMnl_BLAUW, # Background color for the sidebar collapse button (used when collapsiblesidebar is true). | |
| 41 | - | |
| 42 | - 'relbarbgcolor' : _SwBMnl_BLAUW, # Background color for the relation bar(s). ( high & low h-bars) | |
| 43 | - 'relbartextcolor' : _SwBMnl_LBLAUW, # Text color for the relation bar. | |
| 44 | - 'relbarlinkcolor' : _SwBMnl_White, # Link color for the relation bar. | |
| 45 | - | |
| 46 | - 'codebgcolor' : _SwBMnl_SILVER, # Background color for code blocks. | |
| 47 | - 'codetextcolor' : _SwBMnl_BLAUW, # Default text color for code blocks, if not set differently by the highlighting style. | |
| 48 | - | |
| 49 | - 'footerbgcolor' : _SwBMnl_SILVER, # Background color for the footer line. | |
| 50 | - 'footertextcolor' : _SwBMnl_BLAUW, # Text color for the footer line. | |
| 51 | - | |
| 52 | - } |
| @@ -35,23 +35,26 @@ | ||
| 35 | 35 | ### Normal HTML output |
| 36 | 36 | ### |
| 37 | 37 | |
| 38 | -html_theme = 'classic' | |
| 39 | -html_style = 'SwBMnl-sphinx.css' | |
| 40 | - | |
| 41 | -# # HTML-Slides (using Hieroglyph) | |
| 42 | -# #------------------------------- | |
| 43 | -# extensions.append('hieroglyph') | |
| 44 | -# | |
| 45 | -# slide_theme = 'slides' | |
| 46 | -# slide_levels = 2 | |
| 47 | -# | |
| 48 | -# slide_theme_options = {'custom_css': 'SwBMnl-hieroglyph_slides=article.css'} | |
| 49 | -# | |
| 50 | -# slide_link_to_html=False | |
| 51 | -# slide_link_html_to_slides=False | |
| 52 | - | |
| 38 | +html_theme = 'sphinx_rtd_theme' | |
| 39 | +html_theme_options = { | |
| 40 | + 'collapse_navigation': True, | |
| 41 | + 'display_version': True, | |
| 42 | +} | |
| 43 | +html_style = 'SwBMnl+rtfd.css' | |
| 53 | 44 | |
| 54 | 45 | # sphinx.ext.todo |
| 55 | 46 | #----------------- |
| 56 | 47 | extensions.append('sphinx.ext.todo') |
| 57 | 48 | todo_include_todos=True |
| 49 | + | |
| 50 | +# sphinx.ext.autodoc' | |
| 51 | +#-------------------- | |
| 52 | +extensions.append('sphinx.ext.autodoc') | |
| 53 | +autodoc_member_order='bysource' | |
| 54 | + | |
| 55 | + | |
| 56 | +# plantUML | |
| 57 | +#--------- | |
| 58 | +if not on_rtd: | |
| 59 | + extensions.append('sphinxcontrib.plantuml') | |
| 60 | + plantuml = 'java -jar /Users/albert/Apps/PlantUML/libexec/plantuml.jar -nogui' |
| @@ -0,0 +1,19 @@ | ||
| 1 | +/*SwBMnl style on top of 'sphinx_rtd_theme'*/ | |
| 2 | + | |
| 3 | +@import url("css/theme.css"); | |
| 4 | + | |
| 5 | +.wy-nav-top, .wy-nav-side { background-color: #000066;} | |
| 6 | + | |
| 7 | +div.wy-side-nav-search { | |
| 8 | + background-color: #000066; color: #808080; | |
| 9 | + border-bottom: 2px solid #c0c0c0; | |
| 10 | +} | |
| 11 | + | |
| 12 | +h1,h2,h3 { background-color: #808080; color: #eeeeff; | |
| 13 | + margin: 1ex -1em 1ex -1em; | |
| 14 | + padding : 0 1em; | |
| 15 | + } | |
| 16 | + | |
| 17 | +div.wy-nav-content {padding: 1em; | |
| 18 | + max-width: 100%; | |
| 19 | + } |
| @@ -1,88 +0,0 @@ | ||
| 1 | -@import url("classic.css"); | |
| 2 | - | |
| 3 | -/* | |
| 4 | - * In the sidebar ("sphinxsidebar") | |
| 5 | -*/ | |
| 6 | - | |
| 7 | -p.sidebar-title { | |
| 8 | - background-color: #ffffff; color: #000000; | |
| 9 | - font-weight: bold; | |
| 10 | -} | |
| 11 | -/* Make the wrapper blue, for if the page is very short */ | |
| 12 | -div.sphinxsidebarwrapper { background-color: #000066;} | |
| 13 | - | |
| 14 | -/* We show the fulltoc, style it as bullets */ | |
| 15 | -div.sphinxsidebar li.toctree-l1 {list-style-type: square;} | |
| 16 | -div.sphinxsidebar li.toctree-l2 {list-style-type: disc;} | |
| 17 | -div.sphinxsidebar li.toctree-l3 {list-style-type: cirle;} | |
| 18 | - | |
| 19 | - | |
| 20 | - | |
| 21 | -/* | |
| 22 | - * Admonitions | |
| 23 | - */ | |
| 24 | -div.admonition { | |
| 25 | - border: 2px solid #c0c0c0; | |
| 26 | -} | |
| 27 | - | |
| 28 | -div.note { | |
| 29 | - background-color: inherit; | |
| 30 | -} | |
| 31 | -p.admonition-title { color: #000066; } | |
| 32 | - | |
| 33 | - | |
| 34 | -/* | |
| 35 | - * Main text | |
| 36 | - */ | |
| 37 | - | |
| 38 | -div.body {min-height: 80vh;} /* At least 80% the screen (ViewportHeight) */ | |
| 39 | - | |
| 40 | -/* Do not underline the H3 */ | |
| 41 | -div.body h3 { border-bottom: 0; margin-bottom: 0;} | |
| 42 | -h3+p {margin-top: 0;} | |
| 43 | - | |
| 44 | -div.body h1 { margin-bottom: 0;} | |
| 45 | - | |
| 46 | -table.docutils.field-list { width: 100%;} | |
| 47 | -.docutils.field-list tr { border-bottom: 1px solid #000066; border-top: 1px solid #000066;} | |
| 48 | -.docutils.field-list tr:last-child { border-bottom: 2px solid #000066;} | |
| 49 | -.docutils.field-list th { background-color: #00C; color: #eeeeff; font-weight: normal;} | |
| 50 | - | |
| 51 | - | |
| 52 | - | |
| 53 | -/* Make the lead stand out */ | |
| 54 | -div.lead { border: 0; margin:0; | |
| 55 | - border-top: 2px solid #00C; border-bottom: 2px solid #00C; | |
| 56 | - width: 50; margin:0; margin-left:3em; | |
| 57 | - position: relative; float:right; | |
| 58 | - color: #00C; | |
| 59 | - font-size: 80%; font-style: italic; | |
| 60 | - } | |
| 61 | -div.lead div.line-block { border: 0; margin:0;} | |
| 62 | - | |
| 63 | -blockquote { margin-left: 15px; border-left: 5px solid #00C; padding-left: 10px; | |
| 64 | - margin-right: 30px; | |
| 65 | - color: rgb(0%,0%,50%); | |
| 66 | - } | |
| 67 | - | |
| 68 | -/* Blog/Post postcardHeader */ | |
| 69 | -div#postcardHeader { font-size: 80%; float: right;} | |
| 70 | -div#postcardHeader li { float: left; list-style-type: none;} | |
| 71 | -div#postcardHeader+div { clear:both;} | |
| 72 | - | |
| 73 | -/* 'class' keyword in code-doc */ | |
| 74 | -dl.class>dt em.property { | |
| 75 | - font-weight: bold; | |
| 76 | - font-size: 1.2em; | |
| 77 | - color: rgb(0%,0%,50%); | |
| 78 | -} | |
| 79 | - | |
| 80 | -/* default values in class-attribure*/ | |
| 81 | -dl.attribute dt em.property { | |
| 82 | - color: gray; | |
| 83 | - font-weight: normal; | |
| 84 | - font-size: 0.9em; | |
| 85 | - font-family: sans-serif; | |
| 86 | - display: block; padding-left: 3em; | |
| 87 | -} | |
| 88 | - |
| @@ -7,10 +7,8 @@ | ||
| 7 | 7 | from std_conf import * |
| 8 | 8 | |
| 9 | 9 | |
| 10 | -extensions.append('sphinx.ext.autodoc') # Move to std_conf? | |
| 11 | -autodoc_member_order='bysource' | |
| 12 | -import os.path | |
| 13 | -sys.path.append('pyMESS/training/dPID') | |
| 10 | +# For sphinx.ext.autodoc': | |
| 11 | +import os.path; sys.path.append('pyMESS/training/dPID') | |
| 14 | 12 | |
| 15 | 13 | # General information about the project. |
| 16 | 14 | #====================================== |
| @@ -24,14 +22,25 @@ | ||
| 24 | 22 | # Overrule std_conf, where needed |
| 25 | 23 | #================================ |
| 26 | 24 | |
| 27 | -html_title = project + " | " + release # DEFAULT: '<project> v<revision> documentation' -- Strip "documentation" | |
| 28 | - | |
| 29 | - | |
| 30 | -# plantUML | |
| 31 | -#--------- | |
| 32 | -if not on_rtd: | |
| 33 | - extensions.append('sphinxcontrib.plantuml') | |
| 34 | - plantuml = 'java -jar /Users/albert/Apps/PlantUML/libexec/plantuml.jar -nogui' | |
| 25 | +#html_title = project + " | " + release # DEFAULT: '<project> v<revision> documentation' -- Strip "documentation" | |
| 35 | 26 | |
| 36 | 27 | |
| 37 | 28 | |
| 29 | + | |
| 30 | +# ABlog | |
| 31 | +#------ | |
| 32 | +extensions.append('ablog') | |
| 33 | +import ablog; templates_path.append(ablog.get_html_templates_path()) | |
| 34 | +fontawesome_link_cdn = "http://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css" | |
| 35 | +post_date_format = '%Y/%m/%d' | |
| 36 | +post_date_format_short = '%Y/%m' | |
| 37 | + | |
| 38 | +blog_authors = {'GAM' : ('ALbert Mietus', 'http://albert.mietus.nl') } | |
| 39 | +blog_default_author = 'GAM' | |
| 40 | +blog_languages = {'nl' : ('Nederlands', None) } | |
| 41 | +blog_default_language = 'nl' | |
| 42 | +post_always_section = True | |
| 43 | + | |
| 44 | +blog_baseurl = 'http://mess.softwarebetermaken.nl/' | |
| 45 | +disqus_shortname = 'mess-swbmnl' | |
| 46 | +disqus_pages = True |
Fork