Revisión | 986606706b754f07a955897126ee5860bb2177bf (tree) |
---|---|
Tiempo | 2017-11-20 00:25:18 |
Autor | Albert Mietus < albert AT mietus DOT nl > |
Commiter | Albert Mietus < albert AT mietus DOT nl > |
Updated style: use RTfD + additions (BUSY)
@@ -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 |