Asciidoctor navigation bar - asciidoctor

I see that asciidoctor.org itself has a navigation (top) bar. I'm guessing that the website was written using asciidoctor source files. Either way, how do I add a navigation bar using asciidoctor?
Update
This is possibly the wrong question to ask. Perhaps the right way to go is to use awestruct, Middleman, or Jekyll. Advice/suggestions are welcome.

Yes, the source is asciidoctor, but the site is using awestruct for the structure around the content. If you're looking at doing the same kind of thing, we recommend using some other site generation tool for the structure around the content.
Of course if you really want to do this in asciidoctor, you could. You'd need to create your own theme and craft the header that way, but it isn't really recommended because it ties your output to a medium.

Related

Orchard v1.6: customising a theme

New to Orchard in that I just started to play around with it in the past few days. My question is about customising a theme (in this instance the Bootstrap one that can be installed from the gallery)
I tried to have a look and see if there was a non-source code way of doing it but was unable to find this way of doing it so I went spelunking through the theme folder and edited the Layout.cshtml file myself. Is this 'wrong' or is there another 'supported' way of doing it?
What I specifically wanted to do was to have the logo to the left and the menu to the right (see here for the OOB behaviour) and this was the way that I achieved it.
I'm sure if there are any updates to this theme then the customisations will be overwritten hence the question about a supported way to achieve this.
What you may want to do is look up Derived themes, you should create a new theme based off the theme you're modifying, then you can just modify the parts you want, and if the original theme needs updates or w/e you can update it without overwritting all your changes. I'm pretty sure this is the way you should be doing it.
This page should describe how that is done
http://docs.orchardproject.net/Documentation/Customizing-the-default-theme
This is how themes are customized.

how to add editing live website on the website?

if you have ever worked with IPB Forums you will know that you can make changes to your site in the ACP (admin control panel) well what im wanting to do is make something like the one that they use for the "look & feel" part of the forums where you can make changes to the entire website from the one small area i want to add that to my ACP on my main site to make it easier to make changes.
yes i already own a copy of IPB its v3.2.3 if it makes any difference
i appreciate any and all help
Look into adding a "edit in place" function somewhere in your website/forum. Check out:
http://www.appelsiini.net/projects/jeditable
As long as you understand super basic mySQL, PHP, and heard of jQuery/know how to add jQuery plugins to your code, then you are set!
Here is their (link provided above's) demo page:
http://www.appelsiini.net/projects/jeditable/default.html

HTML Purifier setup - having trouble allowing Rich Text, only need the security side

I'm trying to setup HTMLPurifier for my needs. I have it up and running but straight out of the box it strips all formatting. I tried delving through the documentation but that was an exercise in frustration. Is there an easy configuration option that only implements the security aspect of the program and allows through all the rich text styling, etc. I'm not exactly sure how the YUI RTE marks up its output for styling so simply going through and creating a whitelist might be quite time consuming and involve going through both the purifier documentation and the YUI documentation - all for a simple task. Anyone have any premade configurations for this sort of thing or at least a point in the right direction? Thanks.
By default HTML Purifier allows as much styling as possible that can be allowed securely. So you are probably seeing a different problem; my guess is magic quotes. You should var_dump the HTML right before it enters HTML Purifier and turn off magic quotes if there are extra backslashes.

Custom navigation with Liknlist web part

I'm using a standard link list web part. What I want to achieve is before my users click on the link a pop-up javascript warning box will display, stating that they are leaving the domain. In regular anchor tag I would preceed the URL with javascript:ShowWarning('http://www.youtube.com');.
I've search the AllLinks table in the database but did not find the links was looking for.
Where or how are these stored?
Thanks,
Risho
Firstly, editing the SharePoint database directly is a really bad idea. You shouldn't do it unless you really, really know what you are doing, and even then you will probably break the system.
Secondly, any change made in the data will be what shows up in the editor, and I don't think the editor supports links that don't start with "http://".
A better approach is to use jquery to add the popup behaviour to the links when the page is loaded.

Employer wants any non-technical staff to be able to modify content - easy solution?

I'm in a bit of a pickle at work. My department designs a number of internal systems for the company, mostly data-reporting related. We have less than 10 true content pages that actually need to be maintained by a human. These pages were written in PHP and maintained through Dreamweaver by a non-technical staff members - they used the design editor, and avoided the code as much as possible. There were issues, but overall it worked well.
Recently this project was updated and converted to a ASP.NET Web Application. This resulted in some architecture changes, making the content harder to edit with a WYSIWIG editor (it's now revision controlled, it's compiled and thus must be re-deployed after modifications are made, etc.). We sort of assumed that the staff member who had been maintaining it would just continue to do so, now using Visual Studio's "Design" mode instead of Dreamweaver's. We were mistaken, and it isn't an option for technical and non-technical reasons.
The staff member will not be touching any HTML - we need a WYSIWIG editor (this is a requirement we were handed...no arguing with them over that). I started looking at CMS', mainly Drupal, but after a bit of playing around I see that content 'Blocks' don't really have a WYSIWIG editor, instead expecting HTML. Is this true for all CMS'? Is there some easy-to-setup CMS out there that comes with a WYSIWIG editor? Does anyone have any other ideas? Don't care what language it's in, I'll make something work.
This really isn't my area of expertise - I do application development primarily, with an occasional web front-end. Not sure I'm even asking the right question, but hoping someone can help.
WordPress makes use of TinyMCE, and it works pretty well for some NON techie clients of mine. You can write (PHP) scripts that will call the WP functions and pull the page content.
Back to the point, I have found the backend of WordPress to be usable and friendly to a good mix of people. We often use it for a backend and build something completely custom for the frontend, and have had good results.
http://www.cushycms.com/
They let you add easy WYSIWYG capability to any website, regardless of the technology used.
You just add a tag once in your source file, and let your users go to CushyCMS.com to add text content.
I am by no means a CMS expert, but I believe SiteCore might suit your needs. It is a .NET system, built on top of ASP.NET, and from my limited experience with it, the UI for business users is very usable.
Take a look on Joomla. It includes WYSIWYG editor. It is much simpler than Drupal
As Frank points out, TinyMCE is a great option, in fact you use it here :D. Have a look at some examples: http://tinymce.moxiecode.com/examples/full.php
The good point is that TinyMCE is just javascript, so in theory you can add it to any CMS, or in fact to any HTML form.
Also, I think is the default input method for Joomla if you are interested.
I would recommend CKEditor (the successor to the FCKEditor), I haven't used FCKEditor in ASP .NET code, but have used it in PHP with a lot of success. I haven't gotten around to converting old code to CKEditor, but plan to in the future.
If this is something where you can load HTML files from your server that has FTP access...a quick and dirty solution I have used is CushyCMS.com, you supply ftp credentials and hook up the files and they are good to go. Non-technical customers of mine have liked the editor a lot. It allows you to specifically say what you want edited and what you don't.
In PHP the way I usually architect using CushyCMS is to have the main page do a require_once on the content page and the content page has the HTML block that I want them to be able to edit.
so the code looks like this:
<?php
//...other code
require_once("page_content.php");
//...other code
?>
where page_content.php looks something like this:
<div id="whatever" class="cushycms">
editable text here
</div>
Hope this helps.
I used to think that for user friendly editing, you need a WYSIWYG editor, such as the TinyMCE that has already mentioned. Not any more.
Editing content in such a rich text editor is not very handy. Very often you end up messing up the content, and either does a technically savvy person have to come to help, or you have to switch to CODE view (= HTML) to clean up the mess.
Now I'd be far more inclined to use something Markdown, like this site (and Reddit) uses. For most purposes, you don't need rich text, and it is just as handy a WYSIWYG tool. If you need a few rich text touches, like making some text bold or italic, this works quite easily too. Lists, either numbered or bulletted, are a snap. And making links... Those WYSIWYG tools always seem to be able to mess it up in ways you can't even imagine.
Plus, this way, the resulting HTML is always clean and minimal, and it's extremely hard for the user to mess up.
What about Expression Web? It is made to edit ASP.NET web pages, and can integrate with TFS

Resources