COEP-MSBlobStorage

WHAT IS THIS?
=============
NanoWiki is a documentation tool with a small footprint, extreme containment, and maximum portability, even when segments are isolated from a comprehensive constellation. Each element is as self-sustained as possible.
Unlike most content managers, this documentation tool tries to embed as much content as possible into one file, not link resources, like images and/or supportive documents. Therefore these binary files are converted to text, using base64-conversion, then included into the content via straight HTML. The syntax for images, documents, and links is provided as templates, along with explanations and samples.

HOW DOES IT WORK?
=================
CHANGE THE MAIN TITLE...
of the documentation, by double-clicking on it.

ADD ARTICLES...
as needed, bring them into the right order, and save the whole page through the button in the upper left.

EDIT ARTICLES...
by double-clicking them. Then edit and save the whole page (again) with the button in the upper left. Get new images and documents posted, using the conversion tool in the [ADD] section.

NO FONT-SIZE, BOLD, ITALIC, TABLES - NOTHING???
Nope. Enjoy your own HTML-skills, almost everything is supported (but stay away from </textarea> and JavaScript). This is intended to be as simple and bare-bones as possible.
Templates for images and links (to files and pages) are included. Use CAPITALIZATION, +++ additional characters +++, and indentation for emphasis and organization. Worked for decades on a typewriter, works here too.

AND NO 'UNDO...'
In the text-box, right-click and choose UNDO, or press [CTRL]+[Z] / [CTRL]+[Y] for UNDO / REDO.
If you messed up completely, deleted something, open the original you should overwrite after editing in a separate window and get the content from there (open the editor with a double-click).
If you broke the system somehow, do not overwrite the previous version, simply re-load the page, and start over. If you overwrote the original already, get a backup.
MAKE AND KEEP BACKUPS, they compress nicely and fast. Disciplin, people, this is meant to be small, simple, fast, portable, and independent, not fool or vilain proof.

AND NO LOGIN/SECURITY...
Not needed, only you (or your people) have write access to the files. You can write anything on a paper copy, doesn't change the original, neither other people's copies.

HOW DO I SHARE MY DOCUMENTATION?
================================
Give others read access e.g. by posting the wiki on a web server or on a file-sharing platform, like Dropbox or Google Drive. Just find out how to "make file publicly accessible".
Web servers or fully addressible platforms are (only) required to provide cross-linked multi-topic documentation sites instead of single documentation pages.
Here is a handy notes file handler, extract directly into directory with documentation notes on a PHP-enabled web server.

ENJOY! - or improve...

configure credentials

-ready-

-double-click copies code sample-

<?php
/* CENTRALIZED INCLUDE */
require_once 'vendor/autoload.php'; // Azure SDK for PHP

//Load libraries for Azure Data Storage 
use MicrosoftAzure\Storage\Blob\BlobRestProxy;
use MicrosoftAzure\Storage\Common\Exceptions\ServiceException;
use MicrosoftAzure\Storage\Blob\Models\ListBlobsOptions;
use MicrosoftAzure\Storage\Blob\Models\CreateBlockBlobOptions;
use MicrosoftAzure\Storage\Blob\BlobSharedAccessSignatureHelper;
use MicrosoftAzure\Storage\Common\Internal\Resources;

// Credentials for Azure Access
$accountName = '[xxxxxxxxxxxx]';
$accountKey = '[xxxxxxxxxxxx]';
$containerName = '[xxxxxxxxxxxx]';

$connectionString = "DefaultEndpointsProtocol=https;AccountName=$accountName;AccountKey=$accountKey";
$blobClient = BlobRestProxy::createBlobService($connectionString);
/* CENTRALIZED INCLUDE */

/* FILE UPLOAD */

// Image (single file)

// Check if files were submitted
if (isset($_FILES['image'])) {

$name=basename($_FILES['image']['name']);
	// Check if there was an error with the upload
	if ($_FILES['image']['error'] === UPLOAD_ERR_OK) {

$file_error=false; // validation flag

// validate file type
		$valid_mimes= array('image/jpeg','image/png'); //allowed mime types
		if(in_array($_FILES['image']['type'],$valid_mimes)=== false){
			echo "<br />";
			echo '<div class="alert red rounded">
			<p>Image  '.$filename.' not allowed, please choose a valid image format (.jpg or .png).</p>
			</div>';
			$file_error=true;
		}

// limit file size to 5MB
		if($_FILES['image']['size'] > 5242880) {
			echo "Image " . $filename ." must be less than 5 MB<br />";
			$file_error=true;
		}

// Get the temporary file path for the current file
		$tmpFilePath = $_FILES['image']['tmp_name'];

// Make sure the file was uploaded and the path isn't empty and no type or size error reported
		if ($tmpFilePath != "" && !$file_error) {

// modify filename
			$name=date('Y-m-d-h-i-s-A').'-'.str_replace(' ','-',$name);

// Construct a new file array
			$file = array(
				'name' => $name,
				'type' => $_FILES['image']['type'],
				'tmp_name' => $tmpFilePath,
				'error' => $_FILES['image']['error'],
				'size' => $_FILES['image']['size']
			);

// Upload the file to Azure Storage
			$result = uploadDocument('[-subdir-]', $accountName, $accountKey, $containerName, $file);

if ($result['status'] === 'success') {
				// Image uploaded successfully create database emtry
				$document_id = updateImage(
					$_POST['id'], // record_id from event creation
					$name // file source location (path and name)
				);

} else {
				echo "Error: {$result['message']}<br>";
			}
		}
	}
}

/* FILE UPLOAD */

/* FILE READER - generates required tokenized blob-reader URL */

// create blob file access url 
$fileUrl='';
if(!empty($data['image'])){
	$storedPath=$data['image'];
	if(strpos($storedPath,'event_images/')!==0){$storedPath='event_images/'.ltrim($storedPath, '/');}
	$blobName=$storedPath; 
	$sasToken=generateSasToken($containerName,$blobName,$accountName,$accountKey);
	$fileUrl="https://{$accountName}.blob.core.windows.net/"."{$containerName}/{$blobName}?{$sasToken}";
}

/* FILE READER - requires tokenized blob-reader URL */
?>