add 'statusBarMode' to drive whether the status bar is hidden or not.

[mr-fixit]

contents of #221, plus a couple tweaks.

cc @sergiog90

Original PR contents:

Allow developers to show the status bar with navigation bar buttons without overlaps.

If gallery is showed with visible status bar the navigation buttons overlaps it, with this small change you can set to move content origin under status bar to prevent it.

Before:

After:

Code:

private class PhotosViewController: NYTPhotosViewController {
    override var prefersStatusBarHidden: Bool {
        return false
    }
    
    override var preferredStatusBarStyle: UIStatusBarStyle {
        return .lightContent
    }
}

let viewer = PhotosViewController(photos: [photo], initialPhoto: photo, delegate: nil)
viewer.underStatusBar = true
self.present(viewer, animated: true, completion: nil)

[mr-fixit]

@ZevEisenberg, if you like my notch code, this is ready to merge.

[ZevEisenberg]

It's actually pretty rare to mention this stuff in a script like this. If we want to guide people on their ruby setup, maybe we should do it in the readme instead, under a "Contributing" section?

[mr-fixit]

i'm happy to delete it. it's probably wrong-advice anyway.

[ZevEisenberg]

A doc comment instead of a regular comment would make this show up in the inline doc viewer. Probably best to add comments for all the cases.