diff --git a/docs/en/build.md b/docs/build.md similarity index 100% rename from docs/en/build.md rename to docs/build.md diff --git a/docs/en/compiling.md b/docs/compiling.md similarity index 100% rename from docs/en/compiling.md rename to docs/compiling.md diff --git a/docs/en/extn-developer-faq.md b/docs/extn-developer-faq.md similarity index 100% rename from docs/en/extn-developer-faq.md rename to docs/extn-developer-faq.md diff --git a/docs/en/flash.md b/docs/flash.md similarity index 92% rename from docs/en/flash.md rename to docs/flash.md index 7593542355..7e95fd9556 100644 --- a/docs/en/flash.md +++ b/docs/flash.md @@ -37,23 +37,14 @@ Run the following command to flash an *aggregated* binary as is produced for exa ### NodeMCU PyFlasher > Self-contained [NodeMCU](https://github.com/nodemcu/nodemcu-firmware) flasher with GUI based on [esptool.py](https://github.com/espressif/esptool) and [wxPython](https://www.wxpython.org/). -![NodeMCU PyFlasher](../img/NodeMCU-PyFlasher.png "NodeMCU PyFlasher") +![NodeMCU PyFlasher](img/NodeMCU-PyFlasher.png "NodeMCU PyFlasher") Source: [https://github.com/marcelstoer/nodemcu-pyflasher](https://github.com/marcelstoer/nodemcu-pyflasher) -Supported platforms: anything that runs Python, runnable .exe available for Windows and .dmg for macOS +Supported platforms: anything that runs Python, runnable `.exe` available for Windows and `.dmg` for macOS Disclaimer: the availability of [NodeMCU PyFlasher was announced on the NodeMCU Facebook page](https://www.facebook.com/NodeMCU/posts/663197460515251) but it is not an official offering of the current NodeMCU firmware team. -### NodeMCU Flasher -> A firmware Flash tool for NodeMCU...We are working on next version and will use QT framework. It will be cross platform and open-source. - -Source: [https://github.com/nodemcu/nodemcu-flasher](https://github.com/nodemcu/nodemcu-flasher) - -Supported platforms: Windows - -Note that this tool was created by the initial developers of the NodeMCU firmware. **It hasn't seen updates since September 2015** and is not maintained by the current NodeMCU *firmware* team. Be careful to not accidentally flash the very old default firmware the tool is shipped with. - ## Putting Device Into Flash Mode To enable ESP8266 firmware flashing GPIO0 pin must be pulled low before the device is reset. Conversely, for a normal boot, GPIO0 must be pulled high or floating. diff --git a/docs/en/getting-started.md b/docs/getting-started.md similarity index 99% rename from docs/en/getting-started.md rename to docs/getting-started.md index 3d1a1c784b..76da932fbf 100644 --- a/docs/en/getting-started.md +++ b/docs/getting-started.md @@ -325,4 +325,4 @@ Once the LFS image file is on SPIFFS, you can execute the [node.flashreload()](. Do a protected call of this `_init` code: `pcall(node.flashindex("_init"))` and check the error status. See [Programming Techniques and Approachs](lfs.md#programming-techniques-and-approachs) in the LFS whitepaper for a more detailed description. -[↑ back to matrix](#task-os-selector) \ No newline at end of file +[↑ back to matrix](#task-os-selector) diff --git a/docs/en/hardware-faq.md b/docs/hardware-faq.md similarity index 100% rename from docs/en/hardware-faq.md rename to docs/hardware-faq.md diff --git a/docs/index.md b/docs/index.md index ea345dcf49..c8d2999e4c 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,10 +1,10 @@ # NodeMCU Documentation -NodeMCU is an open source [Lua](https://www.lua.org/) based firmware for the [ESP8266 WiFi SOC from Espressif](http://espressif.com/en/products/esp8266/) and uses an on-module flash-based [SPIFFS](https://github.com/pellepl/spiffs) file system. NodeMCU is implemented in C and is layered on the [Espressif NON-OS SDK](https://github.com/espressif/ESP8266_NONOS_SDK). +NodeMCU is an open source [Lua](https://www.lua.org/) based firmware for the [ESP8266 WiFi SOC from Espressif](http://espressif.com/products/esp8266/) and uses an on-module flash-based [SPIFFS](https://github.com/pellepl/spiffs) file system. NodeMCU is implemented in C and is layered on the [Espressif NON-OS SDK](https://github.com/espressif/ESP8266_NONOS_SDK). The firmware was initially developed as is a companion project to the popular ESP8266-based [NodeMCU development modules](https://github.com/nodemcu/nodemcu-devkit-v1.0), but the project is now community-supported, and the firmware can now be run on _any_ ESP module. -→ [Getting Started](en/getting-started.md) +→ [Getting Started](getting-started.md) ## Programming Model The NodeMCU programming model is similar to that of [Node.js](https://en.wikipedia.org/wiki/Node.js), only in Lua. It is asynchronous and event-driven. Many functions, therefore, have parameters for callback functions. To give you an idea what a NodeMCU program looks like study the short snippets below. For more extensive examples have a look at the [`/lua_examples`](https://github.com/nodemcu/nodemcu-firmware/tree/master/lua_examples) folder in the repository on GitHub. @@ -45,10 +45,10 @@ gpio.write(pin, gpio.HIGH) print(gpio.read(pin)) ``` -→ [Getting Started](en/getting-started.md) +→ [Getting Started](getting-started.md) ## Lua Flash Store (LFS) -In September 2018 support for a [Lua Flash Store (LFS)](en/lfs.md) was introduced. LFS allows Lua code and its associated constant data to be executed directly out of flash-memory; just as the firmware itself is executed. This now enables NodeMCU developers to create Lua applications with up to 256Kb Lua code and read-only constants executing out of flash. All of the RAM is available for read-write data! +In September 2018 support for a [Lua Flash Store (LFS)](lfs.md) was introduced. LFS allows Lua code and its associated constant data to be executed directly out of flash-memory; just as the firmware itself is executed. This now enables NodeMCU developers to create Lua applications with up to 256Kb Lua code and read-only constants executing out of flash. All of the RAM is available for read-write data! ## Releases @@ -57,4 +57,4 @@ This project uses two main branches, `master` and `dev`. `dev` is actively worke A new tag is created every time `dev` is merged back to `master`. They are listed in the [releases section on GitHub](https://github.com/nodemcu/nodemcu-firmware/releases). Tag names follow the `-master_yyyymmdd` pattern. ## Up-To-Date Documentation -At the moment the only up-to-date documentation maintained by the current NodeMCU team is in English. It is part of the source code repository (`/docs` subfolder) and kept in sync with the code. \ No newline at end of file +At the moment the only up-to-date documentation maintained by the current NodeMCU team is in English. It is part of the source code repository (`/docs` subfolder) and kept in sync with the code. diff --git a/docs/js/extra.js b/docs/js/extra.js index 1f8c5209aa..e2fef36d74 100644 --- a/docs/js/extra.js +++ b/docs/js/extra.js @@ -1,16 +1,9 @@ var nodemcu = nodemcu || {}; - (function () { 'use strict'; - //var languageCodeToNameMap = {en: 'English', de: 'Deutsch'}; - var languageCodeToNameMap = {en: 'English'}; - var languageNames = values(languageCodeToNameMap); - var defaultLanguageCode = 'en'; $(document).ready(function () { addToc(); - hideNavigationForAllButSelectedLanguage(); - addLanguageSelectorToRtdFlyOutMenu(); replaceRelativeLinksWithStaticGitHubUrl(); }); @@ -45,75 +38,13 @@ var nodemcu = nodemcu || {}; } } - function hideNavigationForAllButSelectedLanguage() { - var selectedLanguageCode = determineSelectedLanguageCode(); - var selectedLanguageName = languageCodeToNameMap[selectedLanguageCode]; - // Finds all subnav elements and hides them if they're /language/ subnavs. Hence, all 'Modules' subnav elements - // won't be hidden. - //