#1459,PR#244: Fix default mathjax js path point to
http://
that cause mixed-content error on HTTPS server. Thanks to sbrandtb and robo9k.PR#157: autodoc remove spurious signatures from @property decorated attributes. Thanks to David Ham.
PR#159: Add coverage targets to quickstart generated Makefile and make.bat. Thanks to Matthias Troffaes.
#1251: When specifying toctree :numbered: option and :tocdepth: metadata, sub section number that is larger depth than
:tocdepth:
is shrunk.PR#260: Encode underscore in citation labels for latex export. Thanks to Lennart Fricke.
PR#264: Fix could not resolve xref for figure node with :name: option. Thanks to Takeshi Komiya.
PR#265: Fix could not capture caption of graphviz node by xref. Thanks to Takeshi Komiya.
PR#263, #1013, #1103: Rewrite of C++ domain. Thanks to Jakob Lykke Andersen.
Hyperlinks to all found nested names and template arguments (#1103).
Support for function types everywhere, e.g., in std::function<bool(int, int)> (#1013).
Support for virtual functions.
Changed interpretation of function arguments to following standard prototype declarations, i.e., void f(arg) means that arg is the type of the argument, instead of it being the name.
Updated tests.
Updated documentation with elaborate description of what declarations are supported and how the namespace declarations influence declaration and cross-reference lookup.
Index names may be different now. Elements are indexed by their fully qualified name. It should be rather easy to change this behaviour and potentially index by namespaces/classes as well.
PR#258, #939: Add dedent option for
code-block
andliteralinclude
. Thanks to Zafar Siddiqui.PR#268: Fix numbering section does not work at singlehtml mode. It still ad-hoc fix because there is a issue that section IDs are conflicted. Thanks to Takeshi Komiya.
PR#273, #1536: Fix RuntimeError with numbered circular toctree. Thanks to Takeshi Komiya.
PR#274: Set its URL as a default title value if URL appears in toctree. Thanks to Takeshi Komiya.
PR#276, #1381:
rfc
andpep
roles support custom link text. Thanks to Takeshi Komiya.PR#277, #1513: highlights for function pointers in argument list of
c:function
. Thanks to Takeshi Komiya.PR#278: Fix section entries were shown twice if toctree has been put under only directive. Thanks to Takeshi Komiya.
#1547: pgen2 tokenizer doesn’t recognize
...
literal (Ellipsis for py3).PR#294: On LaTeX builder, wrap float environment on writing literal_block to avoid separation of caption and body. Thanks to Takeshi Komiya.
PR#295, #1520:
make.bat latexpdf
mechanism tocd
back to the current directory. Thanks to Peter Suter.PR#297, #1571: Add imgpath property to all builders. It make easier to develop builder extensions. Thanks to Takeshi Komiya.
#1584: Point to master doc in HTML “top” link.
#1585: Autosummary of modules broken in Sphinx-1.2.3.
#1610: Sphinx cause AttributeError when MeCab search option is enabled and python-mecab is not installed.
#1674: Do not crash if a module’s
__all__
is not a list of strings.#1673: Fix crashes with
nitpick_ignore
and:doc:
references.#1686: ifconfig directive doesn’t care about default config values.
#1642: Fix only one search result appearing in Chrome.
Documentation¶
Add clarification about the syntax of tags. (
doc/markup/misc.rst
)
版本 1.2.3 (2014年9月1日)¶
添加功能¶
#1518:
sphinx-apidoc
command now has a--version
option to show version information and exitNew locales: Hebrew, European Portuguese, Vietnamese.
修正了错误¶
#636: Keep straight single quotes in literal blocks in the LaTeX build.
#1419: Generated i18n sphinx.js files are missing message catalog entries from ‘.js_t’ and ‘.html’. The issue was introduced from Sphinx-1.1
#1363: Fix i18n: missing python domain’s cross-references with currentmodule directive or currentclass directive.
#1444: autosummary does not create the description from attributes docstring.
#1457: In python3 environment, make linkcheck cause “Can’t convert ‘bytes’ object to str implicitly” error when link target url has a hash part. Thanks to Jorge_C.
#1467: Exception on Python3 if nonexistent method is specified by automethod
#1441: autosummary can’t handle nested classes correctly.
#1499: With non-callable
setup
in a conf.py, now sphinx-build emits a user-friendly error message.#1502: In autodoc, fix display of parameter defaults containing backslashes.
#1226: autodoc, autosummary: importing setup.py by automodule will invoke setup process and execute
sys.exit()
. Now sphinx avoids SystemExit exception and emits warnings without unexpected termination.#1503: py:function directive generate incorrectly signature when specifying a default parameter with an empty list
[]
. Thanks to Geert Jansen.#1508: Non-ASCII filename raise exception on make singlehtml, latex, man, texinfo and changes.
#1531: On Python3 environment, docutils.conf with ‘source_link=true’ in the general section cause type error.
PR#270, #1533: Non-ASCII docstring cause UnicodeDecodeError when uses with inheritance-diagram directive. Thanks to WAKAYAMA shirou.
PR#281, PR#282, #1509: TODO extension not compatible with websupport. Thanks to Takeshi Komiya.
#1477: gettext does not extract nodes.line in a table or list.
#1544:
make text
generates wrong table when it has empty table cells.#1522: Footnotes from table get displayed twice in LaTeX. This problem has been appeared from Sphinx-1.2.1 by #949.
#508: Sphinx every time exit with zero when is invoked from setup.py command. ex.
python setup.py build_sphinx -b doctest
return zero even if doctest failed.
版本 1.2.2 (2014年3月2日)¶
修正了错误¶
PR#211: When checking for existence of the
html_logo
file, check the full relative path and not the basename.PR#212: Fix traceback with autodoc and
__init__
methods without docstring.PR#213: Fix a missing import in the setup command.
#1357: Option names documented by
option
are now again allowed to not start with a dash or slash, and referencing them will work correctly.#1358: Fix handling of image paths outside of the source directory when using the “wildcard” style reference.
#1374: Fix for autosummary generating overly-long summaries if first line doesn’t end with a period.
#1383: Fix Python 2.5 compatibility of sphinx-apidoc.
#1391: Actually prevent using “pngmath” and “mathjax” extensions at the same time in sphinx-quickstart.
#1386: Fix bug preventing more than one theme being added by the entry point mechanism.
#1370: Ignore “toctree” nodes in text writer, instead of raising.
#1364: Fix ‘make gettext’ fails when the ‘.. todolist::’ directive is present.
#1367: Fix a change of PR#96 that break sphinx.util.docfields.Field.make_field interface/behavior for
item
argument usage.
Documentation¶
Extended the documentation about building extensions.
版本 1.2.1 (2014年1月19日)¶
修正了错误¶
#1335: Fix autosummary template overloading with exclamation prefix like
{% extends "!autosummary/class.rst" %}
cause infinite recursive function call. This was caused by PR#181.#1337: Fix autodoc with
autoclass_content="both"
uses uselessobject.__init__
docstring when class does not have__init__
. This was caused by a change for #1138.#1340: Can’t search alphabetical words on the HTML quick search generated with language=’ja’.
#1319: Do not crash if the
html_logo
file does not exist.#603: Do not use the HTML-ized title for building the search index (that resulted in “literal” being found on every page with a literal in the title).
#751: Allow production lists longer than a page in LaTeX by using longtable.
#764: Always look for stopwords lowercased in JS search.
#814: autodoc: Guard against strange type objects that don’t have
__bases__
.#932: autodoc: Do not crash if
__doc__
is not a string.#933: Do not crash if an
option
value is malformed (contains spaces but no option name).#908: On Python 3, handle error messages from LaTeX correctly in the pngmath extension.
#943: In autosummary, recognize “first sentences” to pull from the docstring if they contain uppercase letters.
#923: Take the entire LaTeX document into account when caching pngmath-generated images. This rebuilds them correctly when
pngmath_latex_preamble
changes.#901: Emit a warning when using docutils’ new “math” markup without a Sphinx math extension active.
#845: In code blocks, when the selected lexer fails, display line numbers nevertheless if configured.
#929: Support parsed-literal blocks in LaTeX output correctly.
#949: Update the tabulary.sty packed with Sphinx.
#1050: Add anonymous labels into
objects.inv
to be referenced viaintersphinx
.#1095: Fix print-media stylesheet being included always in the “scrolls” theme.
#1085: Fix current classname not getting set if class description has
:noindex:
set.#1181: Report option errors in autodoc directives more gracefully.
#1155: Fix autodocumenting C-defined methods as attributes in Python 3.
#1233: Allow finding both Python classes and exceptions with the “class” and “exc” roles in intersphinx.
#1198: Allow “image” for the “figwidth” option of the figure directive as documented by docutils.
#1152: Fix pycode parsing errors of Python 3 code by including two grammar versions for Python 2 and 3, and loading the appropriate version for the running Python version.
#1017: Be helpful and tell the user when the argument to
option
does not match the required format.#1345: Fix two bugs with
nitpick_ignore
; now you don’t have to remove the store environment for changes to have effect.#1072: In the JS search, fix issues searching for upper-cased words by lowercasing words before stemming.
#1299: Make behavior of the
math
directive more consistent and avoid producing empty environments in LaTeX output.#1308: Strip HTML tags from the content of “raw” nodes before feeding it to the search indexer.
#1249: Fix duplicate LaTeX page numbering for manual documents.
#1292: In the linkchecker, retry HEAD requests when denied by HTTP 405. Also make the redirect code apparent and tweak the output a bit to be more obvious.
#1285: Avoid name clashes between C domain objects and section titles.
#848: Always take the newest code in incremental rebuilds with the
sphinx.ext.viewcode
extension.#979, #1266: Fix exclude handling in
sphinx-apidoc
.#1302: Fix regression in
sphinx.ext.inheritance_diagram
when documenting classes that can’t be pickled.#1316: Remove hard-coded
font-face
resources from epub theme.#1329: Fix traceback with empty translation msgstr in .po files.
#1300: Fix references not working in translated documents in some instances.
#1283: Fix a bug in the detection of changed files that would try to access doctrees of deleted documents.
#1330: Fix
exclude_patterns
behavior with subdirectories in thehtml_static_path
.#1323: Fix emitting empty
<ul>
tags in the HTML writer, which is not valid HTML.#1147: Don’t emit a sidebar search box in the “singlehtml” builder.
Documentation¶
#1325: Added a “Intersphinx” tutorial section. (
doc/tutorial.rst
)
版本 1.2 (2013年12月10日)¶
添加功能¶
Added
sphinx.version_info
tuple for programmatic checking of the Sphinx version.
不兼容的变化¶
Removed the
sphinx.ext.refcounting
extension – it is very specific to CPython and has no place in the main distribution.
修正了错误¶
Restore
versionmodified
CSS class for versionadded/changed and deprecated directives.PR#181: Fix
html_theme_path = ['.']
is a trigger of rebuild all documents always (This change keeps the current “theme changes cause a rebuild” feature).#1296: Fix invalid charset in HTML help generated HTML files for default locale.
PR#190: Fix gettext does not extract figure caption and rubric title inside other blocks. Thanks to Michael Schlenker.
PR#176: Make sure setup_command test can always import Sphinx. Thanks to Dmitry Shachnev.
#1311: Fix test_linkcode.test_html fails with C locale and Python 3.
#1269: Fix ResourceWarnings with Python 3.2 or later.
#1138: Fix: When
autodoc_docstring_signature = True
andautoclass_content = 'init'
or'both'
, __init__ line should be removed from class documentation.
版本 1.2 beta3 (2013年10月3日)¶
添加功能¶
The Sphinx error log files will now include a list of the loaded extensions for help in debugging.
不兼容的变化¶
PR#154: Remove “sphinx” prefix from LaTeX class name except ‘sphinxmanual’ and ‘sphinxhowto’. Now you can use your custom document class without ‘sphinx’ prefix. Thanks to Erik B.
修正了错误¶
#1265: Fix i18n: crash when translating a section name that is pointed to from a named target.
A wrong condition broke the search feature on first page that is usually index.rst. This issue was introduced in 1.2b1.
#703: When Sphinx can’t decode filenames with non-ASCII characters, Sphinx now catches UnicodeError and will continue if possible instead of raising the exception.
版本 1.2 beta2 (2013年9月17日)¶
添加功能¶
apidoc
now ignores “_private” modules by default, and has an option-P
to include them.apidoc
now has an option to not generate headings for packages and modules, for the case that the module docstring already includes a reST heading.PR#161:
apidoc
can now write each module to a standalone page instead of combining all modules in a package on one page.Builders: rebuild i18n target document when catalog updated.
Support docutils.conf ‘writers’ and ‘html4css1 writer’ section in the HTML writer. The latex, manpage and texinfo writers also support their respective ‘writers’ sections.
The new
html_extra_path
config value allows to specify directories with files that should be copied directly to the HTML output directory.Autodoc directives for module data and attributes now support an
annotation
option, so that the default display of the data/attribute value can be overridden.PR#136: Autodoc directives now support an
imported-members
option to include members imported from different modules.New locales: Macedonian, Sinhala, Indonesian.
Theme package collection by using setuptools plugin mechanism.
不兼容的变化¶
PR#144, #1182: Force timezone offset to LocalTimeZone on POT-Creation-Date that was generated by gettext builder. Thanks to masklinn and Jakub Wilk.
修正了错误¶
PR#132: Updated jQuery version to 1.8.3.
PR#141, #982: Avoid crash when writing PNG file using Python 3. Thanks to Marcin Wojdyr.
PR#145: In parallel builds, sphinx drops second document file to write. Thanks to tychoish.
PR#151: Some styling updates to tables in LaTeX.
PR#153: The “extensions” config value can now be overridden.
PR#155: Added support for some C++11 function qualifiers.
Fix: ‘make gettext’ caused UnicodeDecodeError when templates contain utf-8 encoded strings.
#828: use inspect.getfullargspec() to be able to document functions with keyword-only arguments on Python 3.
#1090: Fix i18n: multiple cross references (term, ref, doc) in the same line return the same link.
#1157: Combination of ‘globaltoc.html’ and hidden toctree caused exception.
#1159: fix wrong generation of objects inventory for Python modules, and add a workaround in intersphinx to fix handling of affected inventories.
#1160: Citation target missing caused an AssertionError.
#1162, PR#139: singlehtml builder didn’t copy images to _images/.
#1173: Adjust setup.py dependencies because Jinja2 2.7 discontinued compatibility with Python < 3.3 and Python < 2.6. Thanks to Alexander Dupuy.
#1185: Don’t crash when a Python module has a wrong or no encoding declared, and non-ASCII characters are included.
#1188: sphinx-quickstart raises UnicodeEncodeError if “Project version” includes non-ASCII characters.
#1189: “Title underline is too short” WARNING is given when using fullwidth characters to “Project name” on quickstart.
#1190: Output TeX/texinfo/man filename has no basename (only extension) when using non-ASCII characters in the “Project name” on quickstart.
#1192: Fix escaping problem for hyperlinks in the manpage writer.
#1193: Fix i18n: multiple link references in the same line return the same link.
#1176: Fix i18n: footnote reference number missing for auto numbered named footnote and auto symbol footnote.
PR#146,#1172: Fix ZeroDivisionError in parallel builds. Thanks to tychoish.
#1204: Fix wrong generation of links to local intersphinx targets.
#1206: Fix i18n: gettext did not translate admonition directive’s title.
#1232: Sphinx generated broken ePub files on Windows.
#1259: Guard the debug output call when emitting events; to prevent the repr() implementation of arbitrary objects causing build failures.
#1142: Fix NFC/NFD normalizing problem of rst filename on Mac OS X.
#1234: Ignoring the string consists only of white-space characters.
版本 1.2 beta1 (2013年3月31日)¶
不兼容的变化¶
Removed
sphinx.util.compat.directive_dwim()
andsphinx.roles.xfileref_role()
which were deprecated since version 1.0.PR#122: the files given in
latex_additional_files
now override TeX files included by Sphinx, such assphinx.sty
.PR#124: the node generated by
versionadded
,versionchanged
anddeprecated
directives now includes all added markup (such as “New in version X”) as child nodes, and no additional text must be generated by writers.PR#99: the
seealso
directive now generates admonition nodes instead of the customseealso
node.
添加功能¶
Markup
The
toctree
directive and thetoctree()
template function now have anincludehidden
option that includes hidden toctree entries (bugs #790 and #1047). A bug in themaxdepth
option for thetoctree()
template function has been fixed (bug #1046).PR#99: Strip down seealso directives to normal admonitions. This removes their unusual CSS classes (admonition-see-also), inconsistent LaTeX admonition title (“See Also” instead of “See also”), and spurious indentation in the text builder.
HTML builder
#783: Create a link to full size image if it is scaled with width or height.
#1067: Improve the ordering of the JavaScript search results: matches in titles come before matches in full text, and object results are better categorized. Also implement a pluggable search scorer.
#1053: The “rightsidebar” and “collapsiblesidebar” HTML theme options now work together.
Update to jQuery 1.7.1 and Underscore.js 1.3.1.
Texinfo builder
An “Index” node is no longer added when there are no entries.
“deffn” categories are no longer capitalized if they contain capital letters.
desc_annotation
nodes are now rendered.strong
andemphasis
nodes are now formatted likeliteral
s. The reason for this is because the standard Texinfo markup (*strong*
and_emphasis_
) resulted in confusing output due to the common usage of using these constructs for documenting parameter names.Field lists formatting has been tweaked to better display “Info field lists”.
system_message
andproblematic
nodes are now formatted in a similar fashion as done by the text builder.“en-dash” and “em-dash” conversion of hyphens is no longer performed in option directive signatures.
@ref
is now used instead of@pxref
for cross-references which prevents the word “see” from being added before the link (does not affect the Info output).The
@finalout
command has been added for better TeX output.transition
nodes are now formatted using underscores (“_”) instead of asterisks (“*”).The default value for the
paragraphindent
has been changed from 2 to 0 meaning that paragraphs are no longer indented by default.#1110: A new configuration value
texinfo_no_detailmenu
has been added for controlling whether a@detailmenu
is added in the “Top” node’s menu.Detailed menus are no longer created except for the “Top” node.
Fixed an issue where duplicate domain indices would result in invalid output.
LaTeX builder:
PR#115: Add
'transition'
item inlatex_elements
for customizing how transitions are displayed. Thanks to Jeff Klukas.PR#114: The LaTeX writer now includes the “cmap” package by default. The
'cmappkg'
item inlatex_elements
can be used to control this. Thanks to Dmitry Shachnev.The
'fontpkg'
item inlatex_elements
now defaults to''
when thelanguage
uses the Cyrillic script. Suggested by Dmitry Shachnev.The
latex_documents
,texinfo_documents
, andman_pages
configuration values will be set to default values based on themaster_doc
if not explicitly set inconf.py
. Previously, if these values were not set, no output would be generated by their respective builders.
Internationalization:
Add i18n capabilities for custom templates. For example: The Sphinx reference documentation in doc directory provides a
sphinx.pot
file with message strings fromdoc/_templates/*.html
when usingmake gettext
.PR#61,#703: Add support for non-ASCII filename handling.
Other builders:
Added the Docutils-native XML and pseudo-XML builders. See
XMLBuilder
andPseudoXMLBuilder
.PR#45: The linkcheck builder now checks
#anchor
s for existence.PR#123, #1106: Add
epub_use_index
configuration value. If provided, it will be used instead ofhtml_use_index
for epub builder.PR#126: Add
epub_tocscope
configuration value. The setting controls the generation of the epub toc. The user can now also include hidden toc entries.PR#112: Add
epub_show_urls
configuration value.
Extensions:
PR#52:
special_members
flag to autodoc now behaves likemembers
.PR#47: Added
sphinx.ext.linkcode
extension.PR#25: In inheritance diagrams, the first line of the class docstring is now the tooltip for the class.
Command-line interfaces:
PR#75: Added
--follow-links
option to sphinx-apidoc.#869: sphinx-build now has the option
-T
for printing the full traceback after an unhandled exception.sphinx-build now supports the standard
--help
and--version
options.sphinx-build now provides more specific error messages when called with invalid options or arguments.
sphinx-build now has a verbose option
-v
which can be repeated for greater effect. A single occurrence provides a slightly more verbose output than normal. Two or more occurrences of this option provides more detailed output which may be useful for debugging.
Locales:
PR#74: Fix some Russian translation.
PR#54: Added Norwegian bokmaal translation.
PR#35: Added Slovak translation.
PR#28: Added Hungarian translation.
#1113: Add Hebrew locale.
#1097: Add Basque locale.
#1037: Fix typos in Polish translation. Thanks to Jakub Wilk.
#1012: Update Estonian translation.
Optimizations:
Speed up building the search index by caching the results of the word stemming routines. Saves about 20 seconds when building the Python documentation.
PR#108: Add experimental support for parallel building with a new
sphinx-build -j
option.
Documentation¶
PR#88: Added the “Sphinx Developer’s Guide” (
doc/devguide.rst
) which outlines the basic development process of the Sphinx project.Added a detailed “Installing Sphinx” document (
doc/install.rst
).
修正了错误¶
PR#124: Fix paragraphs in versionmodified are ignored when it has no dangling paragraphs. Fix wrong html output (nested
<p>
tag). Fix versionmodified is not translatable. Thanks to Nozomu Kaneko.PR#111: Respect add_autodoc_attrgetter() even when inherited-members is set. Thanks to A. Jesse Jiryu Davis.
PR#97: Fix footnote handling in translated documents.
Fix text writer not handling visit_legend for figure directive contents.
Fix text builder not respecting wide/fullwidth characters: title underline width, table layout width and text wrap width.
Fix leading space in LaTeX table header cells.
#1132: Fix LaTeX table output for multi-row cells in the first column.
#1128: Fix Unicode errors when trying to format time strings with a non-standard locale.
#1127: Fix traceback when autodoc tries to tokenize a non-Python file.
#1126: Fix double-hyphen to en-dash conversion in wrong places such as command-line option names in LaTeX.
#1123: Allow whitespaces in filenames given to
literalinclude
.#1120: Added improvements about i18n for themes “basic”, “haiku” and “scrolls” that Sphinx built-in. Thanks to Leonardo J. Caballero G.
#1118: Updated Spanish translation. Thanks to Leonardo J. Caballero G.
#1117: Handle .pyx files in sphinx-apidoc.
#1112: Avoid duplicate download files when referenced from documents in different ways (absolute/relative).
#1111: Fix failure to find uppercase words in search when
html_search_language
is ‘ja’. Thanks to Tomo Saito.#1108: The text writer now correctly numbers enumerated lists with non-default start values (based on patch by Ewan Edwards).
#1102: Support multi-context “with” statements in autodoc.
#1090: Fix gettext not extracting glossary terms.
#1074: Add environment version info to the generated search index to avoid compatibility issues with old builds.
#1070: Avoid un-pickling issues when running Python 3 and the saved environment was created under Python 2.
#1069: Fixed error caused when autodoc would try to format signatures of “partial” functions without keyword arguments (patch by Artur Gaspar).
#1062: sphinx.ext.autodoc use __init__ method signature for class signature.
#1055: Fix web support with relative path to source directory.
#1043: Fix sphinx-quickstart asking again for yes/no questions because
input()
returns values with an extra ‘r’ on Python 3.2.0 + Windows. Thanks to Régis Décamps.#1041: Fix failure of the cpp domain parser to parse a const type with a modifier.
#1038: Fix failure of the cpp domain parser to parse C+11 “static constexpr” declarations. Thanks to Jakub Wilk.
#1029: Fix intersphinx_mapping values not being stable if the mapping has plural key/value set with Python 3.3.
#1028: Fix line block output in the text builder.
#1024: Improve Makefile/make.bat error message if Sphinx is not found. Thanks to Anatoly Techtonik.
#1018: Fix “container” directive handling in the text builder.
#1015: Stop overriding jQuery contains() in the JavaScript.
#1010: Make pngmath images transparent by default; IE7+ should handle it.
#1008: Fix test failures with Python 3.3.
#995: Fix table-of-contents and page numbering for the LaTeX “howto” class.
#976: Fix gettext does not extract index entries.
PR#72: #975: Fix gettext not extracting definition terms before docutils 0.10.
#961: Fix LaTeX output for triple quotes in code snippets.
#958: Do not preserve
environment.pickle
after a failed build.#955: Fix i18n transformation.
#940: Fix gettext does not extract figure caption.
#920: Fix PIL packaging issue that allowed to import
Image
without PIL namespace. Thanks to Marc Schlaich.#723: Fix the search function on local files in WebKit based browsers.
#440: Fix coarse timestamp resolution in some filesystem generating a wrong list of outdated files.
版本 1.1.3 (2012年3月10日)¶
PR#40: Fix
safe_repr
function to decode bytestrings with non-ASCII characters correctly.PR#37: Allow configuring sphinx-apidoc via
SPHINX_APIDOC_OPTIONS
.PR#34: Restore Python 2.4 compatibility.
PR#36: Make the “bibliography to TOC” fix in LaTeX output specific to the document class.
#695: When the highlight language “python” is specified explicitly, do not try to parse the code to recognize non-Python snippets.
#859: Fix exception under certain circumstances when not finding appropriate objects to link to.
#860: Do not crash when encountering invalid doctest examples, just emit a warning.
#864: Fix crash with some settings of
modindex_common_prefix
.#862: Fix handling of
-D
and-A
options on Python 3.#851: Recognize and warn about circular toctrees, instead of running into recursion errors.
#853: Restore compatibility with docutils trunk.
#852: Fix HtmlHelp index entry links again.
#854: Fix inheritance_diagram raising attribute errors on builtins.
#832: Fix crashes when putting comments or lone terms in a glossary.
#834, #818: Fix HTML help language/encoding mapping for all Sphinx supported languages.
#844: Fix crashes when dealing with Unicode output in doctest extension.
#831: Provide
--project
flag in setup_command as advertised.#875: Fix reading config files under Python 3.
#876: Fix quickstart test under Python 3.
#870: Fix spurious KeyErrors when removing documents.
#892: Fix single-HTML builder misbehaving with the master document in a subdirectory.
#873: Fix assertion errors with empty
only
directives.#816: Fix encoding issues in the Qt help builder.
版本 1.1.2 (版本1.1) – 1.1.1无论如何都是一个愚蠢的版本号！¶
#809: Include custom fixers in the source distribution.
版本 1.1.1 (2011年11月1日)¶
#791: 修复QtHelp，DevHelp和HtmlHelp索引条目链接。
#792: Include “sphinx-apidoc” in the source distribution.
#797: 不要在格式错误的词汇表上崩溃。
#801: 在没有SSL支持的情况下使intersphinx正常工作。
#805: Make the
Sphinx.add_index_to_domain
method work correctly.#780: Fix Python 2.5 compatibility.
版本 1.1 (2011年10月9日)¶
不兼容的变化¶
The
py:module
directive doesn’t output itsplatform
option value anymore. (It was the only thing that the directive did output, and therefore quite inconsistent.)Removed support for old dependency versions; requirements are now:
Pygments >= 1.2
Docutils >= 0.7
Jinja2 >= 2.3
添加功能¶
Added Python 3.x support.
New builders and subsystems:
Added a Texinfo builder.
Added i18n support for content, a
gettext
builder and related utilities.Added the
websupport
library and builder.#98: Added a
sphinx-apidoc
script that autogenerates a hierarchy of source files containing autodoc directives to document modules and packages.#273: Add an API for adding full-text search support for languages other than English. Add support for Japanese.
Markup:
#138: Added an
index
role, to make inline index entries.#454: Added more index markup capabilities: marking see/seealso entries, and main entries for a given key.
#460: Allowed limiting the depth of section numbers for HTML using the
toctree
’snumbered
option.#586: Implemented improved
glossary
markup which allows multiple terms per definition.#478: Added
py:decorator
directive to describe decorators.C++ domain now supports array definitions.
C++ domain now supports doc fields (
:param x:
inside directives).Section headings in
only
directives are now correctly handled.Added
emphasize-lines
option to source code directives.#678: C++ domain now supports superclasses.
HTML builder:
Added
pyramid
theme.#559:
html_add_permalinks
is now a string giving the text to display in permalinks.#259: HTML table rows now have even/odd CSS classes to enable “Zebra styling”.
#554: Add theme option
sidebarwidth
to the basic theme.
Other builders:
#516: Added new value of the
latex_show_urls
option to show the URLs in footnotes.#209: Added
text_newlines
andtext_sectionchars
config values.Added
man_show_urls
config value.#472: linkcheck builder: Check links in parallel, use HTTP HEAD requests and allow configuring the timeout. New config values:
linkcheck_timeout
andlinkcheck_workers
.#521: Added
linkcheck_ignore
config value.#28: Support row/colspans in tables in the LaTeX builder.
Configuration and extensibility:
#537: Added
nitpick_ignore
.#306: Added
env-get-outdated
event.Application.add_stylesheet()
now accepts full URIs.
Autodoc:
#564: Add
autodoc_docstring_signature
. When enabled (the default), autodoc retrieves the signature from the first line of the docstring, if it is found there.#176: Provide
private-members
option for autodoc directives.#520: Provide
special-members
option for autodoc directives.#431: Doc comments for attributes can now be given on the same line as the assignment.
#437: autodoc now shows values of class data attributes.
autodoc now supports documenting the signatures of
functools.partial
objects.
Other extensions:
Added the
sphinx.ext.mathjax
extension.#443: Allow referencing external graphviz files.
Added
inline
option to graphviz directives, and fixed the default (block-style) in LaTeX output.#590: Added
caption
option to graphviz directives.#553: Added
testcleanup
blocks in the doctest extension.#594:
trim_doctest_flags
now also removes<BLANKLINE>
indicators.#367: Added automatic exclusion of hidden members in inheritance diagrams, and an option to selectively enable it.
Added
pngmath_add_tooltips
.The math extension displaymath directives now support
name
in addition tolabel
for giving the equation label, for compatibility with Docutils.
New locales:
#221: Added Swedish locale.
#526: Added Iranian locale.
#694: Added Latvian locale.
Added Nepali locale.
#714: Added Korean locale.
#766: Added Estonian locale.
Bugs fixed:
#778: Fix “hide search matches” link on pages linked by search.
Fix the source positions referenced by the “viewcode” extension.
版本 1.0.8 (2011年9月23日)¶
#627: Fix tracebacks for AttributeErrors in autosummary generation.
Fix the
abbr
role when the abbreviation has newlines in it.#727: Fix the links to search results with custom object types.
#648: Fix line numbers reported in warnings about undefined references.
#696, #666: Fix C++ array definitions and template arguments that are not type names.
#633: Allow footnotes in section headers in LaTeX output.
#616: Allow keywords to be linked via intersphinx.
#613: Allow Unicode characters in production list token names.
#720: Add dummy visitors for graphviz nodes for text and man.
#704: Fix image file duplication bug.
#677: Fix parsing of multiple signatures in C++ domain.
#637: Ignore Emacs lock files when looking for source files.
#544: Allow .pyw extension for importable modules in autodoc.
#700: Use
$(MAKE)
in quickstart-generated Makefiles.#734: Make sidebar search box width consistent in browsers.
#644: Fix spacing of centered figures in HTML output.
#767: Safely encode SphinxError messages when printing them to sys.stderr.
#611: Fix LaTeX output error with a document with no sections but a link target.
Correctly treat built-in method descriptors as methods in autodoc.
#706: Stop monkeypatching the Python textwrap module.
#657: viewcode now works correctly with source files that have non-ASCII encoding.
#669: Respect the
noindex
flag option in py:module directives.#675: Fix IndexErrors when including nonexisting lines with
literalinclude
.#676: Respect custom function/method parameter separator strings.
#682: Fix JS incompatibility with jQuery >= 1.5.
#693: Fix double encoding done when writing HTMLHelp .hhk files.
#647: Do not apply SmartyPants in parsed-literal blocks.
C++ domain now supports array definitions.
版本 1.0.7 (2011年1月15日)¶
#347: Fix wrong generation of directives of static methods in autosummary.
#599: Import PIL as
from PIL import Image
.#558: Fix longtables with captions in LaTeX output.
Make token references work as hyperlinks again in LaTeX output.
#572: Show warnings by default when reference labels cannot be found.
#536: Include line number when complaining about missing reference targets in nitpicky mode.
#590: Fix inline display of graphviz diagrams in LaTeX output.
#589: Build using app.build() in setup command.
Fix a bug in the inheritance diagram exception that caused base classes to be skipped if one of them is a builtin.
Fix general index links for C++ domain objects.
#332: Make admonition boundaries in LaTeX output visible.
#573: Fix KeyErrors occurring on rebuild after removing a file.
Fix a traceback when removing files with globbed toctrees.
If an autodoc object cannot be imported, always re-read the document containing the directive on next build.
If an autodoc object cannot be imported, show the full traceback of the import error.
Fix a bug where the removal of download files and images wasn’t noticed.
#571: Implement
~
cross-reference prefix for the C domain.Fix regression of LaTeX output with the fix of #556.
#568: Fix lookup of class attribute documentation on descriptors so that comment documentation now works.
Fix traceback with
only
directives preceded by targets.Fix tracebacks occurring for duplicate C++ domain objects.
Fix JavaScript domain links to objects with
$
in their name.
版本 1.0.6 (2011年1月4日)¶
#581: Fix traceback in Python domain for empty cross-reference targets.
#283: Fix literal block display issues on Chrome browsers.
#383, #148: Support sorting a limited range of accented characters in the general index and the glossary.
#570: Try decoding
-D
and-A
command-line arguments with the locale’s preferred encoding.#528: Observe
locale_dirs
when looking for the JS translations file.#574: Add special code for better support of Japanese documents in the LaTeX builder.
Regression of #77: If there is only one parameter given with
:param:
markup, the bullet list is now suppressed again.#556: Fix missing paragraph breaks in LaTeX output in certain situations.
#567: Emit the
autodoc-process-docstring
event even for objects without a docstring so that it can add content.#565: In the LaTeX builder, not only literal blocks require different table handling, but also quite a few other list-like block elements.
#515: Fix tracebacks in the viewcode extension for Python objects that do not have a valid signature.
Fix strange reports of line numbers for warnings generated from autodoc-included docstrings, due to different behavior depending on docutils version.
Several fixes to the C++ domain.
版本 1.0.5 (2010年11月12日)¶
#557: Add CSS styles required by docutils 0.7 for aligned images and figures.
In the Makefile generated by LaTeX output, do not delete pdf files on clean; they might be required images.
#535: Fix LaTeX output generated for line blocks.
#544: Allow
.pyw
as a source file extension.
版本 1.0.4 (2010年11月12日)¶
#524: Open intersphinx inventories in binary mode on Windows, since version 2 contains zlib-compressed data.
#513: Allow giving non-local URIs for JavaScript files, e.g. in the JSMath extension.
#512: Fix traceback when
intersphinx_mapping
is empty.
版本 1.0.3 (2010年8月23日)¶
#495: Fix internal vs. external link distinction for links coming from a docutils table-of-contents.
#494: Fix the
maxdepth
option for thetoctree()
template callable when used withcollapse=True
.#507: Fix crash parsing Python argument lists containing brackets in string literals.
#501: Fix regression when building LaTeX docs with figures that don’t have captions.
#510: Fix inheritance diagrams for classes that are not picklable.
#497: Introduce separate background color for the sidebar collapse button, making it easier to see.
#502, #503, #496: Fix small layout bugs in several builtin themes.
版本 1.0.2 (2010年8月14日)¶
#490: Fix cross-references to objects of types added by the
add_object_type()
API function.Fix handling of doc field types for different directive types.
Allow breaking long signatures, continuing with backlash-escaped newlines.
Fix unwanted styling of C domain references (because of a namespace clash with Pygments styles).
Allow references to PEPs and RFCs with explicit anchors.
#471: Fix LaTeX references to figures.
#482: When doing a non-exact search, match only the given type of object.
#481: Apply non-exact search for Python reference targets with
.name
for modules too.#484: Fix crash when duplicating a parameter in an info field list.
#487: Fix setting the default role to one provided by the
oldcmarkup
extension.#488: Fix crash when json-py is installed, which provides a
json
module but is incompatible to simplejson.#480: Fix handling of target naming in intersphinx.
#486: Fix removal of
!
for all cross-reference roles.
版本 1.0.1 (2010年7月27日)¶
#470: Fix generated target names for reST domain objects; they are not in the same namespace.
#266: Add Bengali language.
#473: Fix a bug in parsing JavaScript object names.
#474: Fix building with SingleHTMLBuilder when there is no toctree.
Fix display names for objects linked to by intersphinx with explicit targets.
Fix building with the JSON builder.
Fix hyperrefs in object descriptions for LaTeX.
版本 1.0 (2010年7月23日)¶
不兼容的变化¶
Support for domains has been added. A domain is a collection of directives and roles that all describe objects belonging together, e.g. elements of a programming language. A few builtin domains are provided:
Python
C
C++
JavaScript
reStructuredText
The old markup for defining and linking to C directives is now deprecated. It will not work anymore in future versions without activating the
oldcmarkup
extension; in Sphinx 1.0, it is activated by default.Removed support for old dependency versions; requirements are now:
docutils >= 0.5
Jinja2 >= 2.2
Removed deprecated elements:
exclude_dirs
config valuesphinx.builder
module
添加功能¶
General:
Added a “nitpicky” mode that emits warnings for all missing references. It is activated by the
sphinx-build -n
command-line switch or thenitpicky
config value.Added
latexpdf
target in quickstart Makefile.
Markup:
The
menuselection
andguilabel
roles now support ampersand accelerators.New more compact doc field syntax is now recognized:
:param type name: description
.Added
tab-width
option toliteralinclude
directive.Added
titlesonly
option totoctree
directive.Added the
prepend
andappend
options to theliteralinclude
directive.#284: All docinfo metadata is now put into the document metadata, not just the author.
The
ref
role can now also reference tables by caption.The include directive now supports absolute paths, which are interpreted as relative to the source directory.
In the Python domain, references like
:func:`.name`
now look for matching names with any prefix if no direct match is found.
Configuration:
Added
rst_prolog
config value.Added
html_secnumber_suffix
config value to control section numbering format.Added
html_compact_lists
config value to control docutils’ compact lists feature.The
html_sidebars
config value can now contain patterns as keys, and the values can be lists that explicitly select which sidebar templates should be rendered. That means that the builtin sidebar contents can be included only selectively.html_static_path
can now contain single file entries.The new universal config value
exclude_patterns
makes the oldunused_docs
,exclude_trees
andexclude_dirnames
obsolete.Added
html_output_encoding
config value.Added the
latex_docclass
config value and made the “twoside” documentclass option overridable by “oneside”.Added the
trim_doctest_flags
config value, which is true by default.Added
html_show_copyright
config value.Added
latex_show_pagerefs
andlatex_show_urls
config values.The behavior of
html_file_suffix
changed slightly: the empty string now means “no suffix” instead of “default suffix”, useNone
for “default suffix”.
New builders:
Added a builder for the Epub format.
Added a builder for manual pages.
Added a single-file HTML builder.
HTML output:
Inline roles now get a CSS class with their name, allowing styles to customize their appearance. Domain-specific roles get two classes,
domain
anddomain-rolename
.References now get the class
internal
if they are internal to the whole project, as opposed to internal to the current page.External references can be styled differently with the new
externalrefs
theme option for the default theme.In the default theme, the sidebar can experimentally now be made collapsible using the new
collapsiblesidebar
theme option.#129: Toctrees are now wrapped in a
div
tag with classtoctree-wrapper
in HTML output.The
toctree
callable in templates now has amaxdepth
keyword argument to control the depth of the generated tree.The
toctree
callable in templates now accepts atitles_only
keyword argument.Added
htmltitle
block in layout template.In the JavaScript search, allow searching for object names including the module name, like
sys.argv
.Added new theme
haiku
, inspired by the Haiku OS user guide.Added new theme
nature
.Added new theme
agogo
, created by Andi Albrecht.Added new theme
scrolls
, created by Armin Ronacher.#193: Added a
visitedlinkcolor
theme option to the default theme.#322: Improved responsiveness of the search page by loading the search index asynchronously.
Extension API:
Added
html-collect-pages
.Added
needs_sphinx
config value andrequire_sphinx()
application API method.#200: Added
add_stylesheet()
application API method.
Extensions:
Added the
viewcode
extension.Added the
extlinks
extension.Added support for source ordering of members in autodoc, with
autodoc_member_order = 'bysource'
.Added
autodoc_default_flags
config value, which can be used to select default flags for all autodoc directives.Added a way for intersphinx to refer to named labels in other projects, and to specify the project you want to link to.
#280: Autodoc can now document instance attributes assigned in
__init__
methods.Many improvements and fixes to the
autosummary
extension, thanks to Pauli Virtanen.#309: The
graphviz
extension can now output SVG instead of PNG images, controlled by thegraphviz_output_format
config value.Added
alt
option tographviz
extension directives.Added
exclude
argument toautodoc.between()
.
Translations:
Added Croatian translation, thanks to Bojan Mihelač.
Added Turkish translation, thanks to Firat Ozgul.
Added Catalan translation, thanks to Pau Fernández.
Added simplified Chinese translation.
Added Danish translation, thanks to Hjorth Larsen.
Added Lithuanian translation, thanks to Dalius Dobravolskas.
Bugs fixed:
#445: Fix links to result pages when using the search function of HTML built with the
dirhtml
builder.#444: In templates, properly re-escape values treated with the “striptags” Jinja filter.


IEC to purchase new voter registration technology following not-so-indelible ink pen saga
by Azarrah KarrimThe Electoral Commission of South Africa (IEC) says it will soon be issuing a tender for new voter registration technology "intended to support the process of voter registration and to manage the voters' roll on voting day".
In a statement on Monday, the commission said 60 000 portable devices have been purchased to replace aging existing devices known as "zip-zip machines".
Earlier this year, the May 8 national elections saw some controversy after the indelible ink pens, which were meant to be impossible to remove for at least a day, were easily rubbed off by some voters.
READ MORE | ANALYSIS: Did the IEC purchase low quality marking pens to cut costs?
This resulted in some voters voting more than once.
The IEC, however, said the new machines would be a deviation from the current voter registration system which was "now outdated".
"Potential bidders must note that this tender reflects a significant departure from current voter registration practices by the electoral commission.
"The approach used to date, that of scanning an identity document and recording the data, is now outdated and inadequate for future purposes. The electoral commission intends to harness advances in appropriate technology and apply them in this solution," it said.
ALSO READ: Indelible ink vs biometrics - what the voting experts say
The tender will be advertised by the end of November.
While this could potentially prevent voters from casting ballots more than once in the future, Business Insider has decided to take the IEC to court to demand bid documents for the not-so-indelible ink pens.
"We've been asking nicely for the last six months but the IEC won't say - because the Bidvest subsidiary responsible for procuring the pens objects," the publication said.
It added: "Without the information we're asking for, there is no way to tell if SA runs the risk of more indelible ink pens failing in future elections."
On the new technology, the IEC said: "A staggered delivery of the devices is envisaged commencing two months from the date the award is made and concluding no later than March 2021."


Wisconsin job growth down, but economists aren't worried
MILWAUKEE - A federal report shows that Wisconsin's job growth dropped dramatically in the first half of 2019, although economists say there's little cause for concern.
The U.S. Department of Labor says the state had 2,945,000 nonfarm jobs through June, up 9,340 from the same period last year. That lagged well behind the year-over-year increases for every June since the recession ended a decade ago. From June 2017 to June 2018, Wisconsin added 27,000 jobs. The previous year, the state added 35,000.
Dennis Winters, chief economist for the Wisconsin Department of Workforce Development, tells the Journal Sentinel that job growth has slowed nationally and in many other states. He says a key reason is that unemployment continues to be low, at 3.3% in Wisconsin in October and 3.6% nationally.
Winters says many business owners would expand if they had the workforce.


Boris Johnson hints Tories are planning big changes to National Insurance
by Scotsman ReporterBoris Johnson has hinted the Tories are planning a big cut in National Insurance (NI) for low-paid workers when they unveil their General Election manifesto.
The Prime Minister appeared to blurt out the plan to raise the threshold at which workers start paying NI from £8,628 a year to £12,000, during a campaign visit to Teesside.
Speaking during a question-and-answer session with staff at an engineering plant in Middlesbrough, he said the Conservatives were committed to a policy of "low tax for... working people".
He went on: "If you look at what we're doing and what I've said in the last few days, we are going to be cutting National Insurance up to £12,000, we are going to be making sure that we cut business rates for small businesses.
READ MORE - Potentially deadly tick-borne parasite found in Scotland for the first time
"We are cutting tax for working people."
Mr Johnson originally raised the idea of upping the threshold for NI contributions during the Conservative leadership contest last summer - although at that stage he did not put a figure on it.
The Institute for Fiscal Studies (IFS) calculated that for each £1,000 that it was raised, 600,000 workers would be lifted out of NI altogether.
If just employee and self-employed thresholds were lifted the cost to the Exchequer would be £3 billion a year rising to £4.5 billion if the employer threshold was raised as well.
To raise the threshold to £12,500 - as Mr Johnson's then leadership rival Dominic Raab was proposing - was put at £11 billion, rising to £17 billion if the employer threshold was included.
The IFS said that 2.4 million workers would be taken out of NI.
READ MORE - General Election 2019: Nicola Sturgeon warns 'Scotland’s future at risk''


{% extends "layout.html" %} {% block page_title %} Agency work details {% endblock %} {% block content %} {% include "../includes/phase_banner_beta.html" %} Back {% include "../includes/error-summary.html" %} Agency work details How many hours a week did you work before you stopped due to your illness or condition? If your hours varied, enter an average. Job title Agency name Agency address House or flat number and street Town or city County (optional) Postcode {% include "../includes/help.html" %} {% endblock %}
If your hours varied, enter an average.


I am currently in a bootcamp with Actualize. I also work at a financial startup in New York.
I am currently working with the engineering team on small projects as I complete this bootcamp. I also work as an associate in the Client Experience department.
▪ Facilitated open communication between engineering and support teams when dealing with system-wide technical issues. Worked closely with engineering to identify the root cause and expedite restoring functionality. ▪ Gained deep understanding of the product to provide superior technical support. ▪ Translated requests from customers into actionable tickets for engineers. ▪ Evaluated tickets for engineering and reduced those passed through to use engineering resources by 20% by providing work-around or routing to correct team. ▪ Broke down complex issues for clients and co-workers with ease; mentored peers for effective problem-solving, to facilitate quick resolution & customer satisfaction. ▪ Developed more robust internal documentation; consistently top 10 contributor. ▪ Built relationships with clients by exceptional support through email and telephone.
GPA: 3.40
In my spare time, I enjoy going to the Theater. I also enjoy performing both as a singer and an actor.
I keep up to date on the latest movies, and still love the classics. It is always a good time for a Film Noir.


London Park
[90, 50]
|
the Blackburn Monument
[91, 50]
|
the Grose Museum
[92, 50]
|
Atway Lane
[93, 50]
|
the Reade Hotel
[94, 50]
|
the Hatchard Building
[95, 50]
|
Billing Way
[96, 50]
|
the Shoebrooks Building
[97, 50]
|
Winsley Avenue Police Dept
[98, 50]
|
Gwatkin Crescent
[99, 50]
|
Barnete Row School
[90, 51]
|
the Trotman Arms
[91, 51]
|
Knollys Bank
[92, 51]
|
the Christensen Building
[93, 51]
|
McKay Park
[94, 51]
|
the Payn Monument
[95, 51]
|
Ashbee Boulevard Railway Station
[96, 51]
|
a warehouse
[97, 51]
|
Mesney Drive Railway Station
[98, 51]
|
Beckwith Library
[99, 51]
|
Maney Lane Police Dept
[90, 52]
|
Widdows Cinema
[91, 52]
|
Davis Way
[92, 52]
|
the Bowell Museum
[93, 52]
|
a junkyard
[94, 52]
|
wasteland
[95, 52]
|
Lax Cinema
[96, 52]
|
Shadwick Place
[97, 52]
|
Horler Crescent
[98, 52]
|
Hollwey Place
[99, 52]
|
Burye Avenue
[90, 53]
|
Ludlow Auto Repair
[91, 53]
|
Capleton Library
[92, 53]
|
a carpark
[93, 53]
|
Denner Towers
[94, 53]
|
Harman Square
[95, 53]
|
Kidner Park
[96, 53]
|
Hebditch Library
[97, 53]
|
a warehouse
[98, 53]
|
wasteland
[99, 53]
|
the Gyles Monument
[90, 54]
|
Swale Towers
[91, 54]
|
Horsey Square Fire Station
[92, 54]
|
Rake Way
[93, 54]
|
a factory
[94, 54]
|
Colquhoun Avenue
[95, 54]
|
Spenser Road
[96, 54]
|
Simplicius General Hospital
[97, 54]
|
the Hawtrey Museum
[98, 54]
|
Rowbotham Walk
[99, 54]
|
Attrill Lane
[90, 55]
|
a carpark
[91, 55]
|
Neale Street
[92, 55]
|
Edkins Auto Repair
[93, 55]
|
Moorse Cinema
[94, 55]
|
Slack Bank
[95, 55]
|
Elvins Auto Repair
[96, 55]
|
the Sinnott Monument
[97, 55]
|
Deny Street
[98, 55]
|
the Silcock Building
[99, 55]
|
Rogers Road
[90, 56]
|
Fenwyk Avenue
[91, 56]
|
a warehouse
[92, 56]
|
the Kingham Building
[93, 56]
|
Toller Lane
[94, 56]
|
Darnell Square
[95, 56]
|
St Irenaeus's Church
[96, 56]
|
the Barynes Monument
[97, 56]
|
Martine Avenue
[98, 56]
|
the Alcock Building
[99, 56]
|
Durban Library
[90, 57]
|
St Hilary's Church
[91, 57]
|
Trechmann Boulevard
[92, 57]
|
Cowley Walk
[93, 57]
|
the Baylis Building
[94, 57]
|
Edmonds Boulevard
[95, 57]
|
Wingate Park
[96, 57]
|
a cemetery
[97, 57]
|
the Bransom Building
[98, 57]
|
Tolman Power Station
[99, 57]
|
Whatmore Lane
[90, 58]
|
Studham Row
[91, 58]
|
the Wimble Museum
[92, 58]
|
a junkyard
[93, 58]
|
the Rye Arms
[94, 58]
|
the Pape Motel
[95, 58]
|
Dorlan Drive
[96, 58]
|
a carpark
[97, 58]
|
Burges Towers
[98, 58]
|
Tolman Power Station
[99, 58]
|
the Parkinson Building
[90, 59]
|
Clear Drive
[91, 59]
|
Bidgood Square
[92, 59]
|
Gibbs Avenue
[93, 59]
|
Capron Way
[94, 59]
|
Hood Walk
[95, 59]
|
Cowdry Walk
[96, 59]
|
Uppill Place
[97, 59]
|
Bridgewater Square School
[98, 59]
|
the Colbourne Arms
[99, 59]
|
|
Menu
City Map
Find Location
Route Finder
World View
Map Mirror
|


--- layout: page title: "Information technology — Digital compression and coding of continuous-tone still images: JPEG File Interchange Format (JFIF) " description: "The JPEG File Interchange Format (JFIF) is a minimal file format which enables the exchange of JPEG encoded images (according to Rec. ITU-T T.81 / ISO/IEC 10918-1) having 1 or 3 colour channels and 8 bits per colour channel between a wide variety of platforms and applications. This minimal format does not include some advanced features found in various other specified file formats. The purpose of this format is to provide for a basic form of exchange of JPEG images. The optional inclusion of thumbnail images for rapid browsing is also supported." ---
| Document Name: | ISO/IEC 10918-5 |
|---|---|
| Document URI: |
urn:iso:std:iso-iec:10918:-5
|
| Online Version: |
http://www.iso.org/obp/ui/#iso:std:iso-iec:10918:-5
|
| Organization: | International Organization for Standardization (ISO) |
| Series: | International Electrotechnical Commission (IEC) |
| Abstract: | The JPEG File Interchange Format (JFIF) is a minimal file format which enables the exchange of JPEG encoded images (according to Rec. ITU-T T.81 / ISO/IEC 10918-1) having 1 or 3 colour channels and 8 bits per colour channel between a wide variety of platforms and applications. This minimal format does not include some advanced features found in various other specified file formats. The purpose of this format is to provide for a basic form of exchange of JPEG images. The optional inclusion of thumbnail images for rapid browsing is also supported. |
image/jpeg
Return to ( Series | Organization | all Specifications )


rcc Configuration Browser
Control Flow Analyzer
Existing Tool: Configuration Browser. The control flow analyzer
is a database-backed Web interface that allows a network operator to
browse router configuration at a high-level. For example, an
operator can view details about all BGP sessions at a particular router
in the network, all BGP sessions in the network to a particular AS,
etc. The control flow analyzer supports the following features:
- Text-based summary.
- Network graph in dot, edges labeled with route map
identifiers.
- Restricted views: routers with eBGP sessions only, minimum degree, etc.
- Database-backed Configuration Browser
- BGP sessions by router
- BGP sessions by remote AS
- Route maps in normalized form
- "Diffs" between two route maps
- Sort display rows by import or export route map
Note: This part of rcc only works in Cisco IOS at the moment. We
are working on developing a new version.
Examples


Surabaya
Desember, 5th 2000
<EMAIL_ADDRESS>+628563065816
syafiqnd
@syafiqnd
Faculty Information and Communication Technology, Institut Teknologi Sepuluh Nopember
Informatics
Surabaya, Indonesia | 2019 - Present
Team Management
Project Management
Responsibility
Communication
Microsoft Word
Adobe Photoshop
Visual Studio C#
Unity
English
Indonesia
I am very enthusiastic about technology and have a passion in working on projects as a team or even by myself alone. Experienced in working on the project and with a good communication skill I experienced as a project leader. I am imaginative person with high curiosity, and good at planning. I am the one who eager to learn more.
RFID Attendance System (2017)
SMAN 1 Sidoarjo Highschool, responsible to connect RFID System with User Interface
Randomination (2017)
SMAN 1 Sidoarjo Highschool, responsible to create UI Application to show student seats from randomly generated data.
Randomination Mobile (2018)
SMAN 1 Sidoarjo Highschool, responsible to remake all of Randomination Project
PGRI Library (2018)
PGRI 1 Buduran Highschool, responsible to build a library system and data base
Unine Bel (2019)
PGRI 1 Buduran Highschool, responsible to build highschool clock hour reminder
Vovelist : Visual Novel Maker (2019)
Responsible to build software program and design
syqscode.com (2020 - present)
Responsible to build front-end and back-end website
Member of SMAN 1 Sidoarjo Highschool Robotics Club RODA (2017)
Main Secretary of SMAN 1 Sidoarjo Highschool Robotics Club RODA (2017)
1st Winner of Sempoa Kreatif Olympic 2011
Finalist of Indonesia Cerdas Provinsi Jawa Timur
3rd Winner of Sempoa Kreatif Olympic 2012
Participant of SMART Game Programming For Teens 2015
Participant of ITS Schematics NLC 2017
Participant of OSK 2017
Institut Teknologi Sepuluh Nopember (ITS)
Surabaya, Indonesia
Present - 2019
SMAN 1 Sidoarjo Highschool
Sidoarjo, Indonesia
2016 - 2019
SMPN 3 Waru Junior Highschool
Sidoarjo, Indonesia
2013 - 2016
SDN Wage 2 Elementary School
Sidoarjo, Indonesia
2007 - 2013
Software Development
Game Development
Web Development


This is a project
This is a project description. I don't know how long it is hopefully not too long...
This is a project description. I don't know how long it is hopefully not too long...
This is a project description. I don't know how long it is hopefully not too long...
This is a project description. I don't know how long it is hopefully not too long...


In Pictures: Sparring session for PM as Swinson visits young hospital patients
Brexit Party leader Nigel Farage was on the campaign trail in Peterborough.
19 Nov 2019, 17:06
Boris Johnson tried his hand at boxing during a visit to a gym in Manchester ahead of the head-to-head debate with Jeremy Corbyn on ITV later on Tuesday.
Meanwhile, Jo Swinson met patients and staff at a hospital in Southampton and Brexit Party leader Nigel Farage was on the campaign trail in Peterborough.
From left to right, Green Party co-leader Jonathan Bartley, deputy leader Amelia Womack and co-leader Sian Berry visited the London Wetlands Centre for the launch of the Green Party manifesto (Isabel Infantes/PA)
The Green Party said it will invest around £100 billion a year in tackling climate change, including legislation for a ‘green new deal’ intended to set Britain on track to reduce carbon emissions to net zero by 2030 (Isabel Infantes/PA)
In Westminster, shadow chancellor John McDonnell delivered a speech on the economy, saying Labour believes ‘a new business model is needed’ (Steve Parsons/PA)
Boris Johnson tried his hand at boxing as he visited a gym in Manchester, revealing he ‘loves’ the sport (Stefan Rousseau/PA)
The Prime Minister entered the ring with the head coach of Jimmy Egan’s Boxing Academy in Wythenshawe to practise his punches (Stefan Rousseau/PA)
Liberal Democrat leader Jo Swinson visited University Hospital Southampton to push the party’s health plans (Aaron Chown/PA)
Ms Swinson said the Lib Dems would raise an extra £35 billion for the NHS and social care over the next five years by putting a penny on income tax if they take power (Aaron Chown/PA)
Ms Swinson also discussed staffing issues with hospital workers (Aaron Chown/PA)
Meanwhile, Nigel Farage called on Leave-backing Conservative supporters to vote tactically in the General Election (Joe Giddens/PA)
During a rally in Peterborough, the Brexit Party leader addressed supporters about campaign strategy ahead of the election on December 12 (Joe Giddens/PA)
Mr Farage, pictured with Peterborough Brexit Party candidate Mike Greene, left, praised the work of the Liberal Democrats in encouraging tactical voting in the 2017 election and asked Conservatives to ‘lend their votes’ (Joe Giddens/PA)
And in Northern Ireland, the DUP leader made clear her party would not support a Jeremy Corbyn-led Labour government in a hung parliament (Liam McBurney/PA)
Arlene Foster, posing with party colleagues who are due to stand in the election, claimed Mr Corbyn would be bad for the future of the Union (Liam McBurney/PA)
Chancellor Sajid Javid (right) during a visit to Nanaksar Gurdwara in Coventry (Jacob King/PA)


Mozilla Identity Dashboard
Oh oh:
five-
bugs
5
Bugs
Blockers
benadida
:
can't seem to get foobar working
lloyd
:
sick of benadida's constant ranting
×


Control namelist¶
This namelist defines the numerical parameters of the problem plus the variables that control and organize the run.
mode (default
mode=0
) is an integer which controls the type of calculation performed.mode=0
Self-consistent dynamo
mode=1
Convection
mode=2
Kinematic dynamo
mode=3
Magnetic decay modes
mode=4
Magneto convection
mode=5
Linear onset of convection
mode=6
Self-consistent dynamo, but with no Lorentz force
mode=7
Super-rotating inner core or mantle, no convection and no magnetic field
mode=8
Super-rotating inner core or mantle, no convection
mode=9
Super-rotating inner core or mantle, no convection and no Lorentz force
mode=10
Super-rotating inner core or mantle, no convection, no magnetic field, no Lorentz force and no advection
tag (default
tag="default"
) is a character string, used as an extension for all output files.n_time_steps (default
n_time_steps=100
) is an integer, the number of time steps to be performed.tEND (default
tEND=0.0
) is a real, which can be used to force the code to stop when :math:t=tEND
. This is only used whent/=tEND
.alpha (default
alpha=0.5
) is a real. This is the weight used for current time step in implicit time step.
Default scales¶
n_tScale (default
n_tScale=0
) is an integer, which determines the time scalingn_tScale=0
Use viscous time scale.
\(d^2/\nu\)
n_tScale=1
Use magnetic time scale.
\(d^2/\eta\)
n_tScale=2
Use thermal time scale.
\(d^2/\kappa\)
n_tScale=3
Use rotational time scale.
\(\Omega^{-1}\)
n_lScale (default
n_lScale=0
) is an integer which determines the reference length scale.n_lScale=0
Use outer core.
n_lScale=1
Use total core.
enscale (default
enscale=1.0
) is a real. This is the scaling for energies.
Update control¶
l_update_v (default
l_update_v=.true.
) is a logical that specifies whether the velocity field should be time-stepped or not.l_update_b (default
l_update_b=.true.
) is a logical that specifies whether the magnetic field should be time-stepped or not.l_update_s (default
l_update_s=.true.
) is a logical that specifies whether the entropy/temperature should be time-stepped or not.l_update_xi (default
l_update_xi=.true.
) is a logical that specifies whether the chemical composition should be time-stepped or not.
Time step control¶
A modified Courant criterion including a modified Alfven-velocity is used to account for the magnetic field. The relative and absolute importance of flow and Alfven-velocity can be controled by courfac and alffac respectively. The parameter l_cour_alf_damp allows to choose whether the actual Alven speed is used to estimate the Courant condition or if damping is included. Practically, the timestep size is controlled as follows
where \(u_h=(u_\theta^2+u_\phi^2)^{1/2}\), \(\delta h = \dfrac{r}{\sqrt{\ell(\ell+1)}}\), and \(\delta r\) is the radial grid interval. The first term in the left hand side accounts for the explicit treatment of the Coriolis term.
where \(u_{F,r}\) is the radial component of the fluid velocity and \(u_{A,r}=Br/\sqrt{E\,Pm}\) is the radial Alven velocity. The denominator of the rightmost term accounts for the damping of the Alven waves.
dtMax (default
dtMax=1e-4
) is a real. This is the maximum allowed time step \(\delta t\). If \(\delta t > \hbox{dtmax}\), the time step is decreased to at least dtMax (See routine dt_courant). Run is stopped if \(\delta t < \hbox{dtmin}\) and \(\hbox{dtmin}=10^{-6}\,\hbox{dtmax}\).courfac (default
courfac=2.5
) is a real used to scale velocity in Courant criteria. This parameter corresponds to \(c_F\) in the above equation.alffac (default
alffac=1.0
) is a real, used to scale Alfven-velocity in Courant criteria. This parameter corresponds to \(c_A\) in the above equation.intfac (default
intfac=0.15
) is a real, used to scale Coriolis factor in Courant criteria. This parameter corresponds to \(c_I\) in the above equation.l_cour_alf_damp (default
l_cour_alf_damp=.true.
) is a logical. This is used to decide whether the damping of the Alven waves is taken into account when estimating the Courant condition (see Christensen et al., GJI, 1999). At low Ekman numbers, this criterion might actually lead to spurious oscillations/instabilities of the code. When turn to False, \({|u_r|}=c_F{|u_{F,r}|}+c_A{|u_{A,r}|}\).time_scheme (default
time_scheme='CNAB2'
) is a character string. This is used to choose the time step integrator used in the code among the following implicit-explicit time schemes:time_scheme=’CNAB2’
Crank-Nicolson and 2nd order Adams-Bashforth scheme
time_scheme=’CNLF’
Crank-Nicolson and Leap-Frog scheme
time_scheme=’MODCNAB’
Modified CN/AB2
time_scheme=’SBDF2’
Semi-implicit backward difference scheme of 2nd order
time_scheme=’SBDF3’
Semi-implicit backward difference scheme of 3rd order
time_scheme=’SBDF4’
Semi-implicit backward difference scheme of 4th order
time_scheme=’ARS222’
Semi-implicit S-DIRK of 2nd order
time_scheme=’ARS232’
Semi-implicit S-DIRK of 2nd order
time_scheme=’CK232’
Semi-implicit S-DIRK of 2nd order
time_scheme=’LZ232’
Semi-implicit S-DIRK of 2nd order
time_scheme=’CB3’
Semi-implicit S-DIRK of 3rd order
time_scheme=’ARS343’
Semi-implicit S-DIRK of 3rd order
time_scheme=’ARS443’
Semi-implicit S-DIRK of 3rd order
time_scheme=’BPR353’
Semi-implicit S-DIRK of 3rd order
time_scheme=’LZ453’
Semi-implicit S-DIRK of 3rd order
time_scheme=’KC343’
Semi-implicit S-DIRK of 3rd order
time_scheme=’KC564’
Semi-implicit S-DIRK of 4th order
time_scheme=’KC674’
Semi-implicit S-DIRK of 4th order
time_scheme=’KC785’
Semi-implicit S-DIRK of 5th order
Run time¶
The total desired runtime (in human units and not in CPU units) can be specified with the three variables runHours, runMinutes and runSeconds.
runHours (default
runHours=0
) is an integer that controls the number of run hours.runMinutes (default
runMinutes=0
) is an integer that controls the .runSeconds (default
runSeconds=0
) is an integer that controls the number of run hours.
Here is an example for a run of 23h30:
runHours = 23,
runMinutes = 30,
Hyperdiffusivity¶
Hyperdiffusion can be applied by multiplying the diffusion operators by a factor of the form
for the spherical harmonic degrees \(\ell \geq \ell_{hd}\).
difnu (default
difnu=0.0
) is a real. This is the amplitude \(D\) of the viscous hyperdiffusion.difkappa (default
difkappa=0.0
) is a real. This is the amplitude \(D\) of the thermal hyperdiffusion.difchem (default
difchem=0.0
) is a real. This is the amplitude \(D\) of the hyperdiffusion applied to chemical composition.difeta (default
difeta=0.0
) is a real. This is the amplitude \(D\) of the magnetic hyperdiffusion.ldif (default
ldif=1
) is an integer. This is the degree \(\ell_{hd}\) where hyperdiffusion starts to act.ldifexp (default
ldifexp=-1
) is an integer. This is the exponent \(\beta\) of hyperdiffusion.
Angular momentum correction¶
In case of the use of stress-free boundary conditions at both boundaries, it is safer to ensure that the angular momentum is correctly conserved. This can be enforced through the following input variables:
l_correct_AMe (default
l_correct_AMe=.false.
) is a logical. This is used to correct the equatorial angular momentum.l_correct_AMz (default
l_correct_AMz=.false.
) is a logical. This is used to correct the axial angular momentum.
Radial scheme and mapping of the Gauss-Lobatto grid¶
In MagIC, one can either use finite differences or Chebyshev polynomials for the radial integration scheme. This choice is controlled by the following input parameter:
radial_scheme (default
radial_scheme='CHEB'
) is a character string.radial_scheme=’CHEB’
Use Chebyshev polynomials
radial_scheme=’FD’
Use finite differences
When Chebyshev polynomials are used, it is also possible to use a non-linear mapping function to concentrate/diperse grid points around a point inside the domain.
l_newmap (default
l_newmap=.false.
) is a logical. A radial mapping can be applied to the Chebyshev grid whenl_newmap
is set to.true.
. The radial profile of the mapping function is then stored during the initialisation of the code in the file rNM.TAG.map_function (default
map_function='arcsin'
) is a character string. This allows to select which mapping function is used:map_function=’TAN’
Use a tangent mapping (see Bayliss and Turkel 1992)
map_function=’ARCSIN’
Use finite differences (see Kosloff and Tal-Ezer 1993)
If the tangent mapping is used, the function that re-distributes the collocation points is expressed by
where the Gauss-Lobatto collocation points are
and \(r\!\in\![r_i,r_o]\), \(r_{cheb}\!\in\![-1.0,1.0]\). The parameters to calculate \(r\) are
The coefficient \(\alpha_1\) determines the degree of concentration/dispersion of the grid points around \(r_{cheb}\!=\!\alpha_2\). If \(\alpha_1\) is too high, the \(r\) function becomes nearly discontinuous. To avoid numerical problems, \(\alpha_1\) should remain close to unity.
If the arcsin mapping is used, the function that re-distributes the collocation points is given by
In the Kosloff and Tal-Ezer mapping, \(\alpha_1\) transforms the Gauss-Lobatto grid into a more regularly-spaced grid. When \(\alpha_1 \rightarrow 0\) one recovers the Gauss-Lobatto grid, while \(\alpha_1 \rightarrow 1\) yields a regular grid.
Warning
The Kosloff-Tal-Ezer mapping becomes singular when \(\alpha_1=1\). Acceptable values are \(0<\alpha_1<1\). Note that the error increases as \(\epsilon=\left(\frac{1-\sqrt{1-\alpha_1^2}}{\alpha_1}\right)^{N_r}\).
Miscellaneous¶
l_non_rot (default
l_non_rot=.false.
) is a logical. Use it when you want to do non-rotating numerical simulations.anelastic_flavour (default
anelastic_flavour="None"
) is a character string. This allows to change the thermal diffusion operator used within the anelastic approximation. Possible values are:anelastic_flavour=’LBR’
Entropy diffusion
anelastic_flavour=’ENT’
Entropy diffusion
anelastic_flavour=’ALA’
Anelastic liquid approximation
anelastic_flavour=’TDIFF’
Temperature diffusion
anelastic_flavour=’TEMP’
Temperature diffusion
polo_flow_eq (default
polo_flow_eq="WP"
) is a character string. This allows to change how the equation for the poloidal flow potential is constructed. One can either use the radial component of the Navier-Stokes equation and hence keep a coupled system that involve the poloidal potential \(W\) and the pressure \(p\), or take the radial component of the double-curl of the Navier-Stokes equation to suppress pressure.polo_flow_eq=’WP’
Use the pressure formulation
polo_flow_eq=’DC’
Use the double-curl formulation
mpi_transp (default
mpi_transp="auto"
) is a character string. It allows to change the way the global MPI transposes are handled by the code. By default, the code tries to determine by itself the fastest method. One can nevertheless force the code to use local communicators (such as Isend/Irecv/waitall), make use of the native alltoallv MPI variant or choose the alltoallw variant instead.mpi_transp=’auto’
Automatic determination of the fastest transpose
mpi_transp=’p2p’
Use Isend/Irecv/Waitall communicators
mpi_transp=’a2av’
Use alltoallv communicators
mpi_transp=’a2aw’
Use alltoallw communicators
mpi_packing (default
mpi_packing="packed"
) is a character string. It allows to change the size of the global MPI transposes. One can choose between some packing of the fields into buffers (default) or a sequence of single field transposes. There is a possible automatic detection but testing unfortunately reveals frequent false detection.mpi_packing=’auto’
Automatic determination of the fastest transpose
mpi_packing=’packed’
Pack some fields into buffers
mpi_packing=’single’
Transpose each field individually
l_adv_curl (default
l_adv_curl=.false.
) is a logical. When set to True, the advection term is treated as \(\vec{u}\times\vec{\omega}\) instead of \(\vec{u}\vec{\nabla}\vec{u}\). The practical consequence of that is to reduce the number of spectral/spatial Spherical Harmonic Transforms and hence to speed-up the code. Because of the treatment of the viscous heating term in the anelastic approximation, this is only an option when considering Boussinesq models.


If you want to diagnose a problem quickly, you have to understand the information that's available in the Azure Network Watcher logs.
In your engineering company, you want to minimize the time it takes for your staff to diagnose and resolve any network configuration problem. You want to ensure they know which information is available in which logs.
In this module, you'll focus on flow logs, diagnostic logs, and traffic analytics. You'll learn how these tools can help to troubleshoot the Azure network.
Each Microsoft Azure resource can be used up to its quota. Each subscription has separate quotas, and usage is tracked per subscription. Only one instance of Network Watcher is required per subscription per region. This instance gives you a view of usage and quotas so that you can see if you're at risk of hitting a quota.
To view the usage and quota information, go to All Services > Networking > Network Watcher, and then select Usage and quotas. You'll see granular data based on usage and resource location. Data for the following metrics is captured:
Here's an example that shows usage and quotas in the portal:
Network diagnostic logs provide granular data. You'll use this data to understand connectivity and performance issues better. There are three log display tools in Network Watcher:
Let's look at each of these tools.
In flow logs, you can view information about ingress and egress IP traffic on network security groups. Flow logs show outbound and inbound flows on a per-rule basis, based on the network adapter that the flow applies. NSG flow logs show whether traffic was allowed or denied based on the 5-tuple information captured. This information includes:
This diagram shows the workflow that the NSG follows.
Flow logs store data in a JSON file. It can be difficult to gain insights into this data by manually searching the log files, especially if you have a large infrastructure deployment in Azure. You can solve this problem by using Power BI.
In Power BI, you can visualize NSG flow logs by, for example:
You can also use open source tools to analyze your logs, such as Elastic Stack, Grafana, and Graylog.
Note
NSG flow logs don't support storage accounts on the Azure classic portal.
In Network Watcher, diagnostic logs are a central place to enable and disable logs for Azure network resources. These resources might include NSGs, public IPs, load balancers, and app gateways. After you've enabled the logs that interest you, you can use the tools to query and view log entries.
You can import diagnostic logs into Power BI and other tools to analyze them.
To investigate user and app activity across your cloud networks, use traffic analytics.
The tool gives insights into network activity across subscriptions. You can diagnose security threats such as open ports, VMs communicating with known bad networks, and traffic flow patterns. Traffic analytics analyzes NSG flow logs across Azure regions and subscriptions. You can use the data to optimize network performance.
This tool requires Log Analytics. The Log Analytics workspace must exist in a supported region.
Now, let's look at some use case scenarios where Azure Network Watcher metrics and logs can be helpful.
To resolve slow performance, you need to determine the root cause of the problem:
First, check that the VM size is appropriate for the job. Next, enable Azure Diagnostics on the VM to get more granular data for specific metrics, such as CPU usage and memory usage. To enable VM diagnostics via the portal, go to the VM, select Diagnostics Settings, and then turn on diagnostics.
Let's assume you have a VM that has been running fine. However, the VM's performance has recently degraded. To identify if you have any resource bottlenecks, you need to review the captured data.
Start with a time range of captured data before, during, and after the reported problem to get an accurate view of performance. These graphs can also be useful for cross-referencing different resource behaviors in the same period. You'll check for:
When you're looking at performance issues, examine trends and understand if they affect your server. To spot trends, from the portal, use the monitoring graphs. You might see different types of patterns on the monitoring graphs:
If you do observe high CPU utilization, you can either:
If you scale up the VM and the CPU is still running at above 95 percent, is this offering better performance or higher app throughput to an acceptable level? If not, troubleshoot that individual app.
You can view the amount of memory that the VM uses. Logs will help you understand the trend and if it maps to the time at which you see issues. You should not have less than 100 MB of available memory at any time. Watch out for the following trends:
To resolve high memory utilization, consider these solutions:
Network performance might also be related to the storage subsystem of the VM. You can investigate the storage account for the VM in the portal. To identify issues with storage, look at performance metrics from the storage account diagnostics and the VM diagnostics. Look for key trends when the issues occur within a particular time range.
To remediate high disk utilization and latency issues:
To troubleshoot an NSG flow issue, use the Network Watcher IP flow verify tool and NSG flow logging to determine whether an NSG or User Defined Routing (UDR) is interfering with traffic flow.
Run IP flow verify, and specify the local VM and the remote VM. After you select Check, Azure runs a logical test on rules in place. If the result is that access is allowed, use NSG flow logs.
In the portal, go to the NSGs. Under the flow log settings, select On. Now try to connect to the VM again. Use Network Watcher traffic analytics to visualize the data. If the result is that access is allowed, there's no NSG rule in the way.
If you've reached this point and still haven't diagnosed the problem, there might be something wrong on the remote VM. Disable the firewall on the remote VM, and then retest connectivity. If you can connect to the remote VM with the firewall disabled, verify the remote firewall settings. Then re-enable the firewall.
By default, all subnets can communicate in Azure. If two VMs on two subnets can't communicate, there must be a configuration that's blocking communication. Before you check the flow logs, run the IP flow verify tool from the front end VM to the back end VM. This tool runs a logical test on the rules on the network.
If the result is an NSG on the back end subnet blocking all communication, reconfigure that NSG. For security purposes, you must block some communication with the front end because the front end is exposed to the public internet.
By blocking communication to the back end, you limit the amount of exposure in the event of a malware or security attack. However, if the NSG blocks everything, then it's incorrectly configured. Enable the specific protocols and ports that are required.


|
jubilant-funicular
|
Public Attributes | |
| ILuint | valid |
| ILbyte | programtype [16] |
| ILfloat | gamma |
| ILfloat | exposure |
Definition at line 439 of file il_hdr.cpp.
| ILfloat rgbe_header_info::exposure |
Definition at line 445 of file il_hdr.cpp.
| ILfloat rgbe_header_info::gamma |
Definition at line 443 of file il_hdr.cpp.
| ILbyte rgbe_header_info::programtype[16] |
Definition at line 441 of file il_hdr.cpp.
| ILuint rgbe_header_info::valid |
Definition at line 440 of file il_hdr.cpp.


Module: Befog::CLI
- Extended by:
- Befog::Commands::Mixins::Safely
- Defined in:
- lib/befog/cli.rb
Defined Under Namespace
Classes: Error
Constant Summary
- COMMANDS =
{ "add" => Befog::Commands::Add, "remove" => Befog::Commands::Remove, "rm" => Befog::Commands::Remove, "start" => Befog::Commands::Start, "stop" => Befog::Commands::Stop, "run" => Befog::Commands::Run, "list" => Befog::Commands::List, "ls" => Befog::Commands::List, "configure" => Befog::Commands::Configure, "config" => Befog::Commands::Configure }
Class Method Summary (collapse)
Methods included from Befog::Commands::Mixins::Safely
Class Method Details
+ (Object) parse(arguments)
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
# File 'lib/befog/cli.rb', line 31 def self.parse(arguments) = {} key = :bank while not arguments.empty? argument = arguments.shift flag, short, long = /^(?:\-(\w)|\-\-(\w+))$/.match(argument).to_a if flag key = (short or long).to_sym [key] = true else case [key] when Array then [key] << argument when String then [key] = [ [key], argument ] when true, nil then [key] = argument end end end return end |
+ (Object) run(arguments)
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 |
# File 'lib/befog/cli.rb', line 51 def self.run(arguments) subcommand = arguments.shift # TODO: Rejigger this so we can have top-level options # instead of special-casing --version if subcommand == "--version" or subcommand == "-v" Befog.show_version exit if arguments.empty? subcommand = arguments.shift end if subcommand && (command = COMMANDS[subcommand]) command.run(CLI.parse(arguments)) elsif subcommand usage "'#{subcommand}' is not a supported command" else usage end end |
+ (Object) usage(message = nil)
69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
# File 'lib/befog/cli.rb', line 69 def self.usage(=nil) $stderr.puts "befog: #{}" if $stderr.puts <<-eos Usage: befog <subcommand> [<bank>] [<options>] The befog command allows you to manage your cloud servers from the command line. You reference these sets of servers as banks. A bank can have one or many servers. Example: befog add web-servers --count 3 Adds 3 servers to the bank "web-servers" Valid commands: configure, config Configure a bank of servers add Provision new servers for a bank of servers remove, rm De-provision servers start Start servers stop Stop (suspend) servers run Run a command on each of a bank of servers list, ls List servers You can get more options for any command with --help or -h. eos exit(-1) end |


@(html:Html)(implicit request: UserRequestHeader) @import org.denigma.binding.play.UserRequestHeader @isProd = @{ // This is true if we are running a production build, created using dist or stage. In that // case, use the -opt.js file, which is much more optimized, instead of -fastopt.js. play.api.Play.isProd(play.api.Play.current) }


--- layout: page title: Contact permalink: /contact/ --- Reach us at IBSI Google Group Forum or via email address ibsi.help@gmail.com.


Probability Series
Discrete Random Variables
Even though it is named variable, discrete random variable is actually a function that maps the sample space to a set of discrete real values.
- Where
- X is the random variable
- S is the sample space
- R is the set of real numbers
Probability Mass Function
Probability mass function is the probability defined over a given random variable, i.e., it gives the probability that a discrete random variable is exactly equal to some value in the sample space, S.
- For a random variable X, \(p(X=c)\) is denoted as \(p(c)\) and the mapping of each value in sample space to their respective probabilities is known as pmf.
- For all values c that are not is sample space \(p(c) = 0\) because it is pointing to an empty set.
Commutative Distribution Function
Probability defined over an inequality such as \(X \leq c\) gives probabilities of all the events that satisfy the condition from \(-\infty\) to c i.e. the probability value estimate for X less than or equal to c. Mathematically,
Explaination
- Set has 5 boys and 5 girls.
- 3 kids selected at random but gender not known.
- X is the random variable that denotes number of girls selected.
- Event c such that \(X(c) = 3\) is given by set \(c = \{(GGG)\}\) i.e. all three girls selected are girls.
- The pmf for random variable X will be as follows:
| a | p(a) | CD(a) |
|---|---|---|
| 0 | 1/12 | 1/12 |
| 1 | 5/12 | 6/12 |
| 2 | 5/12 | 11/12 |
| 3 | 1/12 | 1 |
- Calculations:
- Number of ways of selecting k kids from total of N kids is given by \(C_k^N = \frac{N!}{k! (N-k)!}\) implies \(C_3^{10} = \frac{10!}{3! (10-3)!} = 120\) for N = 10 and k = 3.
- value 1 : a = 0 means that no girl is selected which implies that k boys are selected out of the total B boys. The number of ways this can be accomplished is given by \(C_k^B = \frac{B!}{k! (B-k)!}\) implies \(C_3^5 = \frac{5!}{3! (5-3)!} = 10\) for B = 5 and k = 3.
- For commutative distribution \(CD(2) = p(0) + p(1) + p(2) = 11/12\).
- Similarly the value of \(p(a)\) and \(CD(a)\) at other values of \(a\) can be calculated.
Random Variable Metrics
Expected Value
The average or mean value calculated over all the possible outcomes of the random variable.
\[E(X) = \sum_n v_i * p(v_i) \tag{3}\]
- X is the random variable.
- \(v_i\) is the value the random variable takes with probability \(p(v_i)\).
- sample space size is n.
- often represented by \(\mu\).
- it is a measure of central tendency of the random variable.
- Some other properties of expected value of a random variable:
Variance and Standard Deviation
Variance gives the dispersion of probability mass around the mean value (i.e. E(X), expected value) of the random variable.
\[Var(X) = E((X-\mu)^2) \tag{6}\] \[\sigma = \sqrt (Var(X)) \tag{7}\]
- \(\sigma\) is the standard deviation.
- Some other properties of variance of a random variable:
\[Var(X) = E(X^2) - (E(X))^2 \label{8} \tag{8}\] \[Var(aX + b) = a^2 Var(X) \label{9} \tag{9}\] \[Var(X+Y) = Var(X) + Var(Y) \text{ iff X and Y are independent } \tag{10}\]
Derivation of equation \eqref{8}
Derivation of equation \eqref{9} using equations \eqref{5}, \eqref{8}
Some Specific Distributions
Uniform Distribution
- All outcomes are equally possible.
- Eg: Probability of getting a heads or tails for a fair coin.
- Uniform(N) implies N outcomes and each has probability 1/N.
Bernoulli Distribution
- Used to model the random experiment where each trail has exactly 2 possible outcomes.
- One possible outcome is termed as success and other as failure.
- Parameter \(p\) is the probability of success in an experiment.
- Random variable \(X \in \{0, 1\}\).
- X = 1 has probability \(p\) and X = 0 has probability \(1-p\) where 0 is denoting failure and 1 denoting success.
Binomial Distribution
- Used to model \(n\) independent trails of Bernoulli Distribution.
- If X follows Binomial(n, p) then, X = k implies, the event of k successes in n independent Bernoulli trials.
\[P(X=k) = C_k^n * (p^k) * ((1-p)^{n-k})\]
- \(C_k^n\) is the number of ways of picking k success events in n total trials.
- \((p^k) * ((1-p)^{n-k})\) gives the combined probability of the n Bernoulli trails.
Geometric Distribution
- Also defined over Bernoulli distribution.
- Models the event of k failures before first success.
- \(geometric(p)\) is given by
\[P(X=k) = (1-p)^k * p\]
where \(X = k\) is the event where first success occured after k failures.
- If X and Y follows geometric distribution with same probability p, then \(X + Y\) is also a geometric distribution.
Expected Value and Variance for Distributions
| Distribution | E(X) | Var(X) |
|---|---|---|
| Uniform | \(\frac{n+1}{2}\) | \(\frac{n^2-1}{12}\) |
| Bernoulli | \(p\) | \(p(1-p)\) |
| Binomial | \(np\) | \(np(1-p)\) |
| Geometric | \(\frac{1-p}{p}\) | \(\frac{1-p}{p^2}\) |


COVID-19 spreads mainly from person to person through respiratory droplets produced when an infected person coughs, sneezes, or talks. Wearing a mask helps to slow the spread of COVID-19 by reducing the risk of asymptomatic transmission.
COVID-19 spreads mainly from person to person through respiratory droplets produced when an infected person coughs, sneezes, or talks. Wearing a mask helps to slow the spread of COVID-19 by reducing the risk of asymptomatic transmission.


Welcome to the Consumee Game! Your task, should you choose to accept it, is to work your way through the game to test your consumer awareness skills. The questions are designed to test all aspects of consumer experiences and the knowledge that comes with them. Good luck!


D3 stands for Data-Driven Documents. It is an open-source JavaScript library developed by Mike Bostock to create custom interactive data visualizations in the web browser using SVG, HTML and CSS.
With the massive amount of data being generated today, communicating this information is getting difficult. Visual representations of data are the most effective means of conveying meaningful information and D3 provides a great deal of ease and flexibility to create these data visualizations. It is dynamic, intuitive and needs minimum amount of effort.


simply put; node.js is a javascript interpreter
node.js =
v8 (javascript engine) + event loop + I/O API
v8 is Chrome's javascript compiler
an event loop is a circular queue that dispatches messages
node.js using its I/O API
can read and write files on the filesystem
node.js inherits javascript's asynchronous nature
fs.readFile('start.html', function (err, data) {
console.log('flag 1');
if (!err) {
console.log('file contents:', data);
} else {
console.log('error:', err);
}
});
console.log('flag 2');
var handlerFunction = function (err, data) {
console.log('flag 1');
if (!err) {
console.log('file contents:', data);
} else {
console.log('error:', err);
}
}
fs.readFile('start.html', handlerFunction);
console.log('flag 2');
node.js is mainly used for backend web development
npm (node.js package manager) is the most used package manager for javascript libraries
and has become a major player on frontend web development
since node.js executes code, it can do anything code can do
from web dev to desktop applications and command line utilities


|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.cycling74.max.MaxObject net.parallaxed.pd.PDHello
public class PDHello
A "Hello World"-esque MaxObject based on pdj_test_class. Pumps a float out of the outlet every clock tick, similar to the PD "metro" object. Two Inlets are defined. The hot inlet on the left side reacts to a "bang" (the "do it" imperative in PD). The cold inlet on the right hand side accepts a value representing the BPM at which the metronome should tick. Read here to understand the difference between hot and cold inlets.
| Field Summary |
|---|
| Fields inherited from class com.cycling74.max.MaxObject |
|---|
EMPTY_STRING_ARRAY, NO_INLETS, NO_OUTLETS |
| Constructor Summary | |
|---|---|
PDHello()
Constructs a MaxObject for PD that accepts a float on the cold inlet (BPM), and a bang on the hot inlet (on/off). |
|
PDHello(com.cycling74.max.Atom[] args)
Constructor used when arguments are passed to the object. |
| Method Summary | |
|---|---|
protected void |
bang()
Called when the object receives a bang from PD. |
void |
execute()
Implements the method executed by MaxClock every clock tick. |
protected void |
inlet(float f)
Called when any float type inlet receives a message. |
| Methods inherited from class com.cycling74.max.MaxObject |
|---|
anything, bail, createInfoOutlet, declareAttribute, declareInlets, declareIO, declareOutlets, declareReadOnlyAttribute, declareTypedIO, embedMessage, error, gc, getContext, getErrorStream, getInfoIdx, getInlet, getInletType, getName, getNumInlets, getNumOutlets, getOutletType, getParentPatcher, getPostStream, inlet, list, loadbang, notifyDeleted, ouch, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outlet, outletBang, outletBangHigh, outletHigh, outletHigh, outletHigh, outletHigh, outletHigh, outletHigh, post, save, setInletAssist, setInletAssist, setName, setOutletAssist, setOutletAssist, showException, showException, viewsource, zap |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public PDHello()
public PDHello(com.cycling74.max.Atom[] args)
args
- An array of Atom objects.| Method Detail |
|---|
public void execute()
execute
in interface com.cycling74.max.Executable
protected void bang()
bang
in class com.cycling74.max.MaxObject
protected void inlet(float f)
inlet
in class com.cycling74.max.MaxObject
f
- A number representing the BPM.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |


elastic - Elasticsearch in R
a
R
Strengths in:
- Data manipulation
- Statistics
- Modeling
- Visualization
Why R + Elasticsearch?
R (powerful data manipulation/analysis/modeling)
+
Elasticsearch (TONS of data, etc.)
Why R + Elasticsearch?
R not great with huge data out of the box
SOOOO
Elasticsearch to the rescue
Why R + Elasticsearch?
Easily communicate findings to others
e.g., rmarkdown/shiny/etc.
Elasticsearch in R
Two clients
elastic
- low level client
elasticdsl
- high level client
Elasticsearch in R
Two clients
elastic
- relatively mature
elasticdsl
- immature
elastic R package
Tested and works with all 1.0 to 2.x versions
Working on 5.x compatibility
elastic - package API
- Search, Search_uri, msearch, scroll
- alias_*
- cat_*
- cluster_*
- docs_bulk
- docs_*
- field_mapping_get, field_stats
- index_*
- mapping_*
- mlt
- termvectors, mtermvectors
- nodes_*
- percolate_*
docs API
docs_create
docs_delete
docs_get
docs_mget
docs_bulk
Datasets ready for ES bulk API
elasticdsl R package
CRAN: not yet
following
elasticsearch-dsl-py
stuff that already works
query()
from()
/size()
fields()
sort()
range()
describe()
/hits()
/n()
ids()
geoshape()
match_all()
prefix()
tabl()
hopefully useable elasticdsl
package out soon ...
i.e., user doesn't need to know much about Elasticsearch
use case: real time viz
use case: real time viz
take home:
- Easily create interactive viz tools
- Including those that respond to live changes
- No knowledge of Javascript/CSS required
use case: stats
use case: geospatial
to do
multiple clients per R session
to do
compatibility with Elasticsearch v5


Call this when you want to use one of the ionic cli commands on your project. Based on the command, Scaffi will redirect it to the appropriate folder.
yo scaffi:ionic browser * *
yo scaffi:ionic info
yo scaffi:ionic emulate *
yo scaffi:ionic platform *
yo scaffi:ionic plugin * *
yo scaffi:ionic run *
yo scaffi:ionic resources
Because Scaffi structure is not exactly Ionic structure, most commands have been brought in to work as if it were ionic.
Some commands are NOT supported, such as serve (which is synonymous to yo scaffi:start *) and build (which is synonymous to yo scaffi:build * *)
Also to note, currently, options do not get passed into an ionic command, such as platform --nosave. Until this issue is fixed, if you need to run an ionic command with an option flag, or a command that is not currently supported, you can navigate to /src/ui/mobile/ and run direct ionic commands there.


Master Rindy:
I am not authorized to train you... Find another captain who is better suited for your profession.
(Only Kamael Warders can undertake this quest.)


Lagos govt discovers lion used as ‘maiguard’ by Indian national
by Samson FolarinSamson Folarin
The Lagos government said it has discovered a lion cub being raised in a residential apartment in the state.
The two-year-old lion is said to be deployed as security guard in the house where it was discovered.
Speaking to our Correspondent on Sunday evening, the Head of Lagos State Task Force on Environmental and Special Offences Unit, Mr. Yinka Egbeyemi, said the cub will be “tranquilised” on Monday.
He said the discovery was made at House No. 229, Muri Okunola Street, in the highbrow Victoria Island area of the state.
The wild animal, reportedly kept by an Indian, was said to have been discovered by residents, who petitioned the state government.
Egbeyemi told The PUNCH that his men had been keeping watch on the house since Friday.
He noted that the animal would be tranquilised on Monday (tomorrow) and taken to a zoo.


This example demonstrates how the Retron image loader can be used to load images from a single path, an array of paths or an object containing paths. It also shows how the forEach property of the loadFromArray and loadFromObject methods be used. In this case we will use it to update a progressbar which indicates the amount of loaded assets.