From 960a3503d72ea5e87b4c4494a0276028febee2e7 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Tue, 18 Jun 2024 07:10:46 -0700 Subject: [PATCH] Improve menu how-to in index, add to FAQ menus The index.html file (from index.md) now links to the no JavaScript menu for those who either wish to use a plaintext menu or for those who the menu does not work (like I discovered with my iPhone 8 Plus - iOS 16 Safari, a bug that was fixed in iOS 17). It also links to a new FAQ about the menus: how they work and also what to do if they don't work. By 'how they work' this refers to on desktop/laptops, on mobile devices: without JavaScript enabled and also on mobile phones and tablets in portrait and also landscape mode plus on mobile devices wider than 1024 pixels and also the browser bug I referred to above. This includes three new png files, screenshots of how it looks on an iPhone 14 Pro Max (which should be like other mobile phones), one which shows the iOS 16 Safari bug and one which shows desktops. These are of course used in the FAQ. Although not every html file has a link to the plaintext (i.e. the menu for those with JavaScript disabled), it is hoped that these two changes will help people navigate if they have a problem with the menus. --- faq.html | 89 +++++++++++++++++++++- faq.md | 127 +++++++++++++++++++++++++++++++- index.html | 4 +- index.md | 4 +- png/ioccc-menu-browser-bug.png | Bin 0 -> 71227 bytes png/ioccc-menu-desktop.png | Bin 0 -> 42098 bytes png/ioccc-menu-mobile-phone.png | Bin 0 -> 72846 bytes 7 files changed, 218 insertions(+), 6 deletions(-) create mode 100644 png/ioccc-menu-browser-bug.png create mode 100644 png/ioccc-menu-desktop.png create mode 100644 png/ioccc-menu-mobile-phone.png diff --git a/faq.html b/faq.html index ada675985..efb7fd634 100644 --- a/faq.html +++ b/faq.html @@ -473,6 +473,7 @@ other inconsistencies with the original entry?
Makefile.
The Makefile is a file used by the make(1) command that contains
rules and UNIX shell-style commands.
The first and default rule should be the “all” rule and should build your entry’s executable file.
+The first and default rule should be the all rule and should build your entry’s executable file.
If your entry depends on a particular source file name during compilation or execution,
your Makefile should copy prog.c into the desired filename. For example:
If you are not familiar Makefiles, you might consider the following tutorials:
Authors of IOCCC winning entries are kept in JSON files of the form:
author/author_handle.json
-where author_handle is an author handle.
+where author_handle is an author handle.
See FAQ 6.5 for more information about author handles.
See FAQ 6.6 for information about the contents of these JSON file and how they are used.
@@ -3142,6 +3143,90 @@ mode you can do this easily: make sure you’re in command mode (in most cases y can hit ESC to do this) and then type the command: :set tabstop=4
where 4 is the value you wish to set the tabstop to.
The way the menu works on desktops or laptops is that you should simply see the +menu directly without the need of JavaScript or any intervention on your part. +It should look something like:
+
Simply move your mouse cursor over the category you want and then click on the +item you wish to view that drops down from the category.
+This is likely how it will appear with a tablet device in landscape +mode, too, unless JavaScript is +disabled.
+ +If, however, you’re on a mobile device, it can vary, depending on the dimensions +and whether or not you have JavaScript enabled.
+ +For instance, on an iPhone 14 +Pro Max or similar device (in dimensions), you should see at the top right of +every page, something that looks like:
+
In this case click on the icon at the top right corner that looks like:
+![]()
to activate the menu.
+ +If JavaScript is disabled on any mobile device, tablet or phone, you should see +the words:
+ Please Enable JavaScript
+at the top right corner; clicking on this will take you to the no JavaScript +menu which is a plaintext menu. You of course can use this if +you like, even if you do not have JavaScript enabled, by pointing your browser +to https://ioccc-src.github.io/temp-test-ioccc/nojs-menu.html.
+ +With tablets, it likely depends on the orientation you have your device in. If it’s +in portrait mode you likely will see the menu that one will get on a mobile +phone.
+If, on the other hand, you are using landscape mode, say on an iPad Pro 11 inch +4th generation, then you will likely see the menu as you would on a desktop or +laptop.
+ +Finally, if you’re on a mobile device that is wider than 1024 pixels, you will +very possibly have to press and hold the menu icon:
+![]()
to activate it. You can then use it as you would on a mobile +phone.
+ +It was noticed that in iOS 16 Safari (both on an iPhone 8 Plus and in simulation +mode in macOS) the menu does not work at all. That is to say one might see:
+
Notice how the menu icon is not even there! This happens in both portrait mode +and landscape mode.
+In this case one will have to use the no JavaScript +menu. If you have a fix for this that does NOT +affect the usability of desktops, laptops or other mobile devices, please +consider fixing it and opening a pull request or at +least report it as an +issue (choose +the category Website issue).
Jump to: top
WAD(Hqfe!{tVoPUdyuMWGrwX?>ad8eWdU