From ba531f5a667adb86daa2eba58d456b68c2265b9d Mon Sep 17 00:00:00 2001 From: smnh Date: Mon, 5 Nov 2018 18:14:16 -0800 Subject: [PATCH 1/8] Added "widgets" option to list widget The "widgets" option allows defining lists of different item types. --- .../src/ObjectWidgetTopBar.js | 110 +++++++++++++----- .../src/ListControl.js | 44 +++++-- website/content/docs/widgets/list.md | 55 ++++++++- 3 files changed, 166 insertions(+), 43 deletions(-) diff --git a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js index 995e33b184f3..f12d8e3edc98 100644 --- a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js +++ b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js @@ -3,6 +3,7 @@ import PropTypes from 'prop-types'; import styled, { css } from 'react-emotion'; import Icon from './Icon'; import { colors, buttons } from './styles'; +import ImmutablePropTypes from "react-immutable-proptypes"; const TopBarContainer = styled.div` align-items: center; @@ -51,36 +52,85 @@ const AddButton = styled.button` } `; -const ObjectWidgetTopBar = ({ - allowAdd, - onAdd, - onCollapseToggle, - collapsed, - heading = null, - label, -}) => ( - - - - - - {heading} - - {!allowAdd ? null : ( - - Add {label} +const AddItem = styled.div` + display: flex; + justify-content: center; + align-items: center; +`; + +class ObjectWidgetTopBar extends React.Component { + static propTypes = { + allowAdd: PropTypes.bool, + widgets: ImmutablePropTypes.list, + onAdd: PropTypes.func, + onCollapseToggle: PropTypes.func, + collapsed: PropTypes.bool, + heading: PropTypes.node, + label: PropTypes.string, + }; + + constructor(props) { + super(props); + + this.state = {widget: !this.props.widgets || this.props.widgets.size === 0 ? null : this.props.widgets.get(0).get('name')}; + } + + handleWidgetChange = (event) => { + this.setState({widget: event.target.value}); + }; + + handleAdd = (e) => { + if (this.state.widget) { + this.props.onAdd(e, this.state.widget); + } else { + this.props.onAdd(e); + } + }; + + addItemUI() { + if (!this.props.allowAdd) { + return null; + } + const widgets = this.props.widgets; + const addButton = ( + + Add {this.props.label} - )} - -); - -ObjectWidgetTopBar.propTypes = { - allowAdd: PropTypes.bool, - onAdd: PropTypes.func, - onCollapseToggle: PropTypes.func, - collapsed: PropTypes.bool, - heading: PropTypes.node, - label: PropTypes.string, -}; + ); + + if (widgets && widgets.size > 0) { + return ( + + + {addButton} + + ); + } else { + return addButton; + } + } + + render() { + const { + onCollapseToggle, + collapsed, + heading = null, + } = this.props; + + return ( + + + + + + {heading} + + {this.addItemUI()} + + ); + } +} export default ObjectWidgetTopBar; diff --git a/packages/netlify-cms-widget-list/src/ListControl.js b/packages/netlify-cms-widget-list/src/ListControl.js index 0cdb275b6074..87aa993bd455 100644 --- a/packages/netlify-cms-widget-list/src/ListControl.js +++ b/packages/netlify-cms-widget-list/src/ListControl.js @@ -57,6 +57,7 @@ const SortableList = SortableContainer(({ items, renderItem }) => { const valueTypes = { SINGLE: 'SINGLE', MULTIPLE: 'MULTIPLE', + MIXED: 'MIXED' }; export default class ListControl extends React.Component { @@ -101,6 +102,8 @@ export default class ListControl extends React.Component { return valueTypes.MULTIPLE; } else if (field.get('field')) { return valueTypes.SINGLE; + } else if (field.get('widgets')) { + return valueTypes.MIXED; } else { return null; } @@ -143,10 +146,13 @@ export default class ListControl extends React.Component { this.props.setInactiveStyle(); }; - handleAdd = e => { + handleAdd = (e, widget) => { e.preventDefault(); const { value, onChange } = this.props; - const parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); + let parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); + if (this.getValueType() === valueTypes.MIXED && widget) { + parsedValue = parsedValue.set('widget', widget) + } this.setState({ itemsCollapsed: this.state.itemsCollapsed.push(false) }); onChange((value || List()).push(parsedValue)); }; @@ -163,7 +169,7 @@ export default class ListControl extends React.Component { const { value, metadata, onChange, field } = this.props; const collectionName = field.get('name'); const newObjectValue = - this.getValueType() === valueTypes.MULTIPLE + this.getValueType() !== valueTypes.SINGLE ? this.getObjectValue(index).set(fieldName, newValue) : newValue; const parsedMetadata = { @@ -208,6 +214,12 @@ export default class ListControl extends React.Component { objectLabel(item) { const { field } = this.props; + if (this.getValueType() === valueTypes.MIXED) { + const itemWidget = item.get('widget'); + const widgets = field.get('widgets'); + const widget = widgets.find(widget => widget.get('name') === itemWidget); + return widget.get('label', widget.get('name')); + } const multiFields = field.get('fields'); const singleField = field.get('field'); const labelField = (multiFields && multiFields.first()) || singleField; @@ -233,9 +245,16 @@ export default class ListControl extends React.Component { }; renderItem = (item, index) => { - const { field, classNameWrapper, editorControl, resolveWidget } = this.props; + const { classNameWrapper, editorControl, resolveWidget } = this.props; const { itemsCollapsed } = this.state; const collapsed = itemsCollapsed.get(index); + let field = this.props.field; + + if (this.getValueType() === valueTypes.MIXED) { + const itemWidget = item.get('widget'); + const widgets = field.get('widgets'); + field = widgets.find(widget => widget.get('name') === itemWidget); + } return ( ); } + + render() { + if (this.getValueType() !== null) { + return this.renderListControl(); + } else { + return this.renderInput(); + } + } } diff --git a/website/content/docs/widgets/list.md b/website/content/docs/widgets/list.md index f0cf2398a0be..2eff15c9d1c3 100644 --- a/website/content/docs/widgets/list.md +++ b/website/content/docs/widgets/list.md @@ -3,16 +3,17 @@ label: "List" title: list --- -The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. +The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list with different widgets to create list of different item types. - **Name:** `list` -- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values +- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values. If `widgets` is specified instead, the list will render items of different widget types. - **Data type:** list of widget values - **Options:** - `default`: if `fields` is specified, declare defaults on the child widgets; if not, you may specify a list of strings to populate the text field - - `allow_add`: if added and labeled `false`, button to add additional widgets disappears + - `allow_add`: if added and labeled `false`, button to add additional widgets disappears. When user together with `widgets`, additional control for selecting a widget type will be available. - `field`: a single widget field to be repeated - `fields`: a nested list of multiple widget fields to be included in each repeatable iteration + - `widgets`: a nested list of widgets. Each widget will define different item type that could be added to the list. - **Example** (`field`/`fields` not specified): ```yaml - label: "Tags" @@ -49,3 +50,51 @@ The list widget allows you to create a repeatable item in the UI which saves as - {label: Name, name: name, widget: string, default: "Emmet"} - {label: Avatar, name: avatar, widget: image, default: "/img/emmet.jpg"} ``` +- **Example** (with `widgets`): + ```yaml + - label: "Home Section" + name: "sections" + widget: "list" + widgets: + - label: "Carousel" + name: "carousel" + widget: object + fields: + - {label: Header, name: header, widget: string, default: "Image Gallery"} + - {label: Template, name: template, widget: string, default: "carousel.html"} + - label: Images + name: images + widget: list + field: {label: Image, name: image, widget: image} + - label: "Spotlight" + name: "spotlight" + widget: object + fields: + - {label: Header, name: header, widget: string, default: "Spotlight"} + - {label: Template, name: template, widget: string, default: "spotlight.html"} + - {label: Text, name: text, widget: text, default: "Hello World"} + ``` + Above list widget may be used to create following frontmatter with two carousel and one spotlight sections: + ```yaml + title: Home + sections: + - widget: carousel + header: Image Gallery + template: carousel.html + images: + - images/image01.png + - images/image02.png + - images/image03.png + - widget: spotlight + header: Spotlight + template: spotlight.html + text: Hello World + - widget: carousel + header: Image Gallery + template: carousel.html + images: + - images/image04.png + - images/image05.png + - images/image06.png + ``` + The `widget` field must be present on each section object and will be added automatically when new section is created through CMS. From 07ef9ee71cedb95404fc61b1861fe59c065347d6 Mon Sep 17 00:00:00 2001 From: smnh Date: Wed, 7 Nov 2018 15:24:01 -0800 Subject: [PATCH 2/8] More work on list with types - changed widgets field to types - added typeKey property - added list preview for lists and objects --- .../EditorPreviewPane/EditorPreviewPane.js | 94 +++++++++++++++---- packages/netlify-cms-lib-util/src/index.js | 1 + .../netlify-cms-lib-util/src/mixedWidget.js | 23 +++++ .../src/ObjectWidgetTopBar.js | 27 +++--- .../src/ListControl.js | 22 ++--- .../src/ObjectPreview.js | 4 +- website/content/docs/widgets/list.md | 21 +++-- 7 files changed, 140 insertions(+), 52 deletions(-) create mode 100644 packages/netlify-cms-lib-util/src/mixedWidget.js diff --git a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js index a439db9ae330..02f9ee09866f 100644 --- a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js +++ b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js @@ -12,6 +12,7 @@ import { INFERABLE_FIELDS } from 'Constants/fieldInference'; import EditorPreviewContent from './EditorPreviewContent.js'; import PreviewHOC from './PreviewHOC'; import EditorPreview from './EditorPreview'; +import { TYPES_KEY, resolveFunctionForMixedField } from 'netlify-cms-lib-util'; const PreviewPaneFrame = styled(Frame)` width: 100%; @@ -21,6 +22,11 @@ const PreviewPaneFrame = styled(Frame)` border-radius: ${lengths.borderRadius}; `; +const nestedListStyle = { + marginTop: 0, + paddingLeft: '2em' +}; + export default class PreviewPane extends React.Component { getWidget = (field, value, props, idx = null) => { const { fieldsMetaData, getAsset, entry } = props; @@ -68,9 +74,14 @@ export default class PreviewPane extends React.Component { // custom preview templates, where the field object can't be passed in. let field = fields && fields.find(f => f.get('name') === name); let value = values && values.get(field.get('name')); + let mixedWidgets = field.get(TYPES_KEY); let nestedFields = field.get('fields'); let singleField = field.get('field'); + if (mixedWidgets) { + field = field.set(TYPES_KEY, this.getMixedWidgets(field, value)); + } + if (nestedFields) { field = field.set('fields', this.getNestedWidgets(nestedFields, value)); } @@ -82,14 +93,10 @@ export default class PreviewPane extends React.Component { const labelledWidgets = ['string', 'text', 'number']; if (Object.keys(this.inferedFields).indexOf(name) !== -1) { value = this.inferedFields[name].defaultPreview(value); - } else if ( - value && - labelledWidgets.indexOf(field.get('widget')) !== -1 && - value.toString().length < 50 - ) { + } else if (labelledWidgets.indexOf(field.get('widget')) !== -1) { value = (
- {field.get('label', field.get('name'))}: {value} + {field.get('label', field.get('name'))}: {value && value.toString().length < 50 ? value : {'undefined'}}
); } @@ -97,30 +104,76 @@ export default class PreviewPane extends React.Component { return value ? this.getWidget(field, value, this.props) : null; }; + getMixedWidgets = (field, values) => { + const mixedFieldResolver = resolveFunctionForMixedField(field); + if (!values) { + return null; + } else if (List.isList(values)) { + return ( +
    + {values.map((value, idx) => { + const field = mixedFieldResolver(value); + const fields = field.get('fields'); + return ( +
  • + Item {idx + 1} [{field.get('label', field.get('name'))}]: {this.getNestedWidgets(fields, value)} +
    • + ); + })} +
+ ) + } else { + const fields = mixedFieldResolver(values).get('fields'); + return this.getNestedWidgets(fields, values); + } + }; + /** * Retrieves widgets for nested fields (children of object/list fields) */ getNestedWidgets = (fields, values) => { // Fields nested within a list field will be paired with a List of value Maps. if (List.isList(values)) { - return values.map(value => this.widgetsForNestedFields(fields, value)); + return ( +
    + {values.map((value, idx) => ( +
  • + Item {idx + 1}: {this.widgetsForNestedFields(fields, value)} +
    • + ))} +
+ ); } // Fields nested within an object field will be paired with a single Map of values. return this.widgetsForNestedFields(fields, values); }; - getSingleNested = (field, values) => { - if (List.isList(values)) { - return values.map((value, idx) => this.getWidget(field, value, this.props, idx)); - } - return this.getWidget(field, values, this.props); - }; - /** * Use widgetFor as a mapping function for recursive widget retrieval */ widgetsForNestedFields = (fields, values) => { - return fields.map(field => this.widgetFor(field.get('name'), fields, values)); + return ( +
    + {fields.map((field, idx) => ( +
  • {this.widgetFor(field.get('name'), fields, values)}
    • + ))} +
+ ); + }; + + getSingleNested = (field, values) => { + if (List.isList(values)) { + return ( +
    + {values.map((value, idx) => ( +
  • + Item {idx + 1}: {this.getWidget(field, value, this.props, idx)} +
    • + ))} +
+ ); + } + return this.getWidget(field, values, this.props); }; /** @@ -132,11 +185,16 @@ export default class PreviewPane extends React.Component { widgetsFor = name => { const { fields, entry } = this.props; const field = fields.find(f => f.get('name') === name); - const nestedFields = field && field.get('fields'); + const mixedWidgets = field && field.get(TYPES_KEY); + const mixedFieldResolver = mixedWidgets && resolveFunctionForMixedField(field); const value = entry.getIn(['data', field.get('name')]); + let nestedFields = field && field.get('fields'); if (List.isList(value)) { return value.map(val => { + if (mixedFieldResolver) { + nestedFields = mixedFieldResolver(val).get('fields'); + } const widgets = nestedFields && Map( @@ -149,6 +207,10 @@ export default class PreviewPane extends React.Component { }); } + if (mixedFieldResolver) { + nestedFields = mixedFieldResolver(value).get('fields'); + } + return Map({ data: value, widgets: diff --git a/packages/netlify-cms-lib-util/src/index.js b/packages/netlify-cms-lib-util/src/index.js index 3654ab761d5c..da27152c717c 100644 --- a/packages/netlify-cms-lib-util/src/index.js +++ b/packages/netlify-cms-lib-util/src/index.js @@ -7,3 +7,4 @@ export { filterPromises, resolvePromiseProperties, then } from './promise'; export unsentRequest from './unsentRequest'; export { filterByPropExtension, parseResponse, responseParser } from './backendUtil'; export loadScript from './loadScript'; +export { TYPES_KEY, TYPE_KEY, DEFAULT_TYPE_KEY, getTypedFieldForValue, resolveFunctionForMixedField, resolveFieldKeyType } from './mixedWidget'; diff --git a/packages/netlify-cms-lib-util/src/mixedWidget.js b/packages/netlify-cms-lib-util/src/mixedWidget.js new file mode 100644 index 000000000000..273c85edba69 --- /dev/null +++ b/packages/netlify-cms-lib-util/src/mixedWidget.js @@ -0,0 +1,23 @@ +export const TYPES_KEY = 'types'; +export const TYPE_KEY = 'typeKey'; +export const DEFAULT_TYPE_KEY = 'type'; + +export function getTypedFieldForValue(field, value) { + const typeKey = resolveFieldKeyType(field); + const types = field.get(TYPES_KEY); + const valueType = value.get(typeKey); + return types.find(type => type.get('name') === valueType); +} + +export function resolveFunctionForMixedField(field) { + const typeKey = resolveFieldKeyType(field); + const types = field.get(TYPES_KEY); + return (value) => { + const valueType = value.get(typeKey); + return types.find(type => type.get('name') === valueType); + } +} + +export function resolveFieldKeyType(field) { + return field.get(TYPE_KEY, DEFAULT_TYPE_KEY); +} diff --git a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js index f12d8e3edc98..438860a9ff54 100644 --- a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js +++ b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js @@ -61,7 +61,7 @@ const AddItem = styled.div` class ObjectWidgetTopBar extends React.Component { static propTypes = { allowAdd: PropTypes.bool, - widgets: ImmutablePropTypes.list, + types: ImmutablePropTypes.list, onAdd: PropTypes.func, onCollapseToggle: PropTypes.func, collapsed: PropTypes.bool, @@ -72,37 +72,40 @@ class ObjectWidgetTopBar extends React.Component { constructor(props) { super(props); - this.state = {widget: !this.props.widgets || this.props.widgets.size === 0 ? null : this.props.widgets.get(0).get('name')}; + let type = null; + if (this.props.types && this.props.types.size > 0) { + type = this.props.types.get(0).get('name'); + } + + this.state = { + type: type + }; } handleWidgetChange = (event) => { - this.setState({widget: event.target.value}); + this.setState({type: event.target.value}); }; handleAdd = (e) => { - if (this.state.widget) { - this.props.onAdd(e, this.state.widget); - } else { - this.props.onAdd(e); - } + this.props.onAdd(e, this.state.type); }; addItemUI() { if (!this.props.allowAdd) { return null; } - const widgets = this.props.widgets; + const types = this.props.types; const addButton = ( Add {this.props.label} ); - if (widgets && widgets.size > 0) { + if (types && types.size > 0) { return ( - + {types.map((type, idx) => )} {addButton} diff --git a/packages/netlify-cms-widget-list/src/ListControl.js b/packages/netlify-cms-widget-list/src/ListControl.js index 87aa993bd455..696f80b7417f 100644 --- a/packages/netlify-cms-widget-list/src/ListControl.js +++ b/packages/netlify-cms-widget-list/src/ListControl.js @@ -6,6 +6,7 @@ import { List, Map } from 'immutable'; import { partial } from 'lodash'; import { SortableContainer, SortableElement, SortableHandle } from 'react-sortable-hoc'; import { ObjectControl } from 'netlify-cms-widget-object'; +import { TYPES_KEY, getTypedFieldForValue, resolveFieldKeyType} from 'netlify-cms-lib-util'; import { ListItemTopBar, ObjectWidgetTopBar, @@ -102,7 +103,7 @@ export default class ListControl extends React.Component { return valueTypes.MULTIPLE; } else if (field.get('field')) { return valueTypes.SINGLE; - } else if (field.get('widgets')) { + } else if (field.get(TYPES_KEY)) { return valueTypes.MIXED; } else { return null; @@ -146,12 +147,12 @@ export default class ListControl extends React.Component { this.props.setInactiveStyle(); }; - handleAdd = (e, widget) => { + handleAdd = (e, type, typeKey) => { e.preventDefault(); const { value, onChange } = this.props; let parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); - if (this.getValueType() === valueTypes.MIXED && widget) { - parsedValue = parsedValue.set('widget', widget) + if (this.getValueType() === valueTypes.MIXED && type) { + parsedValue = parsedValue.set(typeKey, type) } this.setState({ itemsCollapsed: this.state.itemsCollapsed.push(false) }); onChange((value || List()).push(parsedValue)); @@ -215,10 +216,7 @@ export default class ListControl extends React.Component { objectLabel(item) { const { field } = this.props; if (this.getValueType() === valueTypes.MIXED) { - const itemWidget = item.get('widget'); - const widgets = field.get('widgets'); - const widget = widgets.find(widget => widget.get('name') === itemWidget); - return widget.get('label', widget.get('name')); + return getTypedFieldForValue(field, item).get('label', field.get('name')); } const multiFields = field.get('fields'); const singleField = field.get('field'); @@ -251,9 +249,7 @@ export default class ListControl extends React.Component { let field = this.props.field; if (this.getValueType() === valueTypes.MIXED) { - const itemWidget = item.get('widget'); - const widgets = field.get('widgets'); - field = widgets.find(widget => widget.get('name') === itemWidget); + field = getTypedFieldForValue(field, item); } return ( @@ -294,8 +290,8 @@ export default class ListControl extends React.Component {
this.handleAdd(e, type, resolveFieldKeyType(field))} heading={`${items.size} ${listLabel}`} label={labelSingular.toLowerCase()} onCollapseToggle={this.handleCollapseAllToggle} diff --git a/packages/netlify-cms-widget-object/src/ObjectPreview.js b/packages/netlify-cms-widget-object/src/ObjectPreview.js index 605c3f558d5c..e5f0cdce7d12 100644 --- a/packages/netlify-cms-widget-object/src/ObjectPreview.js +++ b/packages/netlify-cms-widget-object/src/ObjectPreview.js @@ -1,10 +1,12 @@ import React from 'react'; import PropTypes from 'prop-types'; import { WidgetPreviewContainer } from 'netlify-cms-ui-default'; +import { TYPES_KEY } from 'netlify-cms-lib-util'; const ObjectPreview = ({ field }) => ( - {(field && field.get('fields')) || field.get('field') || null} +
{field.get('label', field.get('name'))}
+ {(field && (field.get(TYPES_KEY)) || field.get('fields') || field.get('field')) || null} ); diff --git a/website/content/docs/widgets/list.md b/website/content/docs/widgets/list.md index 2eff15c9d1c3..28c26c4e0671 100644 --- a/website/content/docs/widgets/list.md +++ b/website/content/docs/widgets/list.md @@ -3,17 +3,18 @@ label: "List" title: list --- -The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list with different widgets to create list of different item types. +The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list with different widget types. - **Name:** `list` -- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values. If `widgets` is specified instead, the list will render items of different widget types. +- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values. If `types` is specified instead, the list will render items of different widget types. - **Data type:** list of widget values - **Options:** - `default`: if `fields` is specified, declare defaults on the child widgets; if not, you may specify a list of strings to populate the text field - - `allow_add`: if added and labeled `false`, button to add additional widgets disappears. When user together with `widgets`, additional control for selecting a widget type will be available. + - `allow_add`: if added and labeled `false`, button to add additional widgets disappears. When used together with `types`, additional control for selecting a widget type will be available. - `field`: a single widget field to be repeated - `fields`: a nested list of multiple widget fields to be included in each repeatable iteration - - `widgets`: a nested list of widgets. Each widget will define different item type that could be added to the list. + - `types`: a nested list of widgets. Each widget will define different item type that could be added to the list. + - `typeKey`: the name of the field that will be added to every item in list representing the name of the widget type that item belongs to. Ignored if `types` is not defined. Default is `type`. - **Example** (`field`/`fields` not specified): ```yaml - label: "Tags" @@ -50,12 +51,12 @@ The list widget allows you to create a repeatable item in the UI which saves as - {label: Name, name: name, widget: string, default: "Emmet"} - {label: Avatar, name: avatar, widget: image, default: "/img/emmet.jpg"} ``` -- **Example** (with `widgets`): +- **Example** (with `types`): ```yaml - label: "Home Section" name: "sections" widget: "list" - widgets: + types: - label: "Carousel" name: "carousel" widget: object @@ -78,18 +79,18 @@ The list widget allows you to create a repeatable item in the UI which saves as ```yaml title: Home sections: - - widget: carousel + - type: carousel header: Image Gallery template: carousel.html images: - images/image01.png - images/image02.png - images/image03.png - - widget: spotlight + - type: spotlight header: Spotlight template: spotlight.html text: Hello World - - widget: carousel + - type: carousel header: Image Gallery template: carousel.html images: @@ -97,4 +98,4 @@ The list widget allows you to create a repeatable item in the UI which saves as - images/image05.png - images/image06.png ``` - The `widget` field must be present on each section object and will be added automatically when new section is created through CMS. + The `type` field must be present on each section object and will be added automatically when new section is created through CMS. To use different name for this field, set the `typeKey`. From dff9c44f51b457b7a72cf48d340a5e162713da15 Mon Sep 17 00:00:00 2001 From: smnh Date: Thu, 8 Nov 2018 12:56:38 -0800 Subject: [PATCH 3/8] fixed formatting --- .../EditorPreviewPane/EditorPreviewPane.js | 14 +++++++--- packages/netlify-cms-lib-util/src/index.js | 9 +++++- .../netlify-cms-lib-util/src/mixedWidget.js | 4 +-- .../src/ObjectWidgetTopBar.js | 28 +++++++++++-------- .../src/ListControl.js | 6 ++-- .../src/ObjectPreview.js | 2 +- 6 files changed, 40 insertions(+), 23 deletions(-) diff --git a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js index 02f9ee09866f..71958e3a3e3a 100644 --- a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js +++ b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js @@ -24,7 +24,7 @@ const PreviewPaneFrame = styled(Frame)` const nestedListStyle = { marginTop: 0, - paddingLeft: '2em' + paddingLeft: '2em', }; export default class PreviewPane extends React.Component { @@ -96,7 +96,12 @@ export default class PreviewPane extends React.Component { } else if (labelledWidgets.indexOf(field.get('widget')) !== -1) { value = (
- {field.get('label', field.get('name'))}: {value && value.toString().length < 50 ? value : {'undefined'}} + {field.get('label', field.get('name'))}:{' '} + {value && value.toString().length < 50 ? ( + value + ) : ( + {'undefined'} + )}
); } @@ -116,12 +121,13 @@ export default class PreviewPane extends React.Component { const fields = field.get('fields'); return (
  • - Item {idx + 1} [{field.get('label', field.get('name'))}]: {this.getNestedWidgets(fields, value)} + {`Item ${idx + 1} [${field.get('label', field.get('name'))}]:`}{' '} + {this.getNestedWidgets(fields, value)}
    • ); })} - ) + ); } else { const fields = mixedFieldResolver(values).get('fields'); return this.getNestedWidgets(fields, values); diff --git a/packages/netlify-cms-lib-util/src/index.js b/packages/netlify-cms-lib-util/src/index.js index da27152c717c..fde60d428520 100644 --- a/packages/netlify-cms-lib-util/src/index.js +++ b/packages/netlify-cms-lib-util/src/index.js @@ -7,4 +7,11 @@ export { filterPromises, resolvePromiseProperties, then } from './promise'; export unsentRequest from './unsentRequest'; export { filterByPropExtension, parseResponse, responseParser } from './backendUtil'; export loadScript from './loadScript'; -export { TYPES_KEY, TYPE_KEY, DEFAULT_TYPE_KEY, getTypedFieldForValue, resolveFunctionForMixedField, resolveFieldKeyType } from './mixedWidget'; +export { + TYPES_KEY, + TYPE_KEY, + DEFAULT_TYPE_KEY, + getTypedFieldForValue, + resolveFunctionForMixedField, + resolveFieldKeyType, +} from './mixedWidget'; diff --git a/packages/netlify-cms-lib-util/src/mixedWidget.js b/packages/netlify-cms-lib-util/src/mixedWidget.js index 273c85edba69..414f8fc8bedc 100644 --- a/packages/netlify-cms-lib-util/src/mixedWidget.js +++ b/packages/netlify-cms-lib-util/src/mixedWidget.js @@ -12,10 +12,10 @@ export function getTypedFieldForValue(field, value) { export function resolveFunctionForMixedField(field) { const typeKey = resolveFieldKeyType(field); const types = field.get(TYPES_KEY); - return (value) => { + return value => { const valueType = value.get(typeKey); return types.find(type => type.get('name') === valueType); - } + }; } export function resolveFieldKeyType(field) { diff --git a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js index 438860a9ff54..06eef4ffc924 100644 --- a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js +++ b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js @@ -3,7 +3,7 @@ import PropTypes from 'prop-types'; import styled, { css } from 'react-emotion'; import Icon from './Icon'; import { colors, buttons } from './styles'; -import ImmutablePropTypes from "react-immutable-proptypes"; +import ImmutablePropTypes from 'react-immutable-proptypes'; const TopBarContainer = styled.div` align-items: center; @@ -78,15 +78,15 @@ class ObjectWidgetTopBar extends React.Component { } this.state = { - type: type + type: type, }; } - handleWidgetChange = (event) => { - this.setState({type: event.target.value}); + handleWidgetChange = event => { + this.setState({ type: event.target.value }); }; - handleAdd = (e) => { + handleAdd = e => { this.props.onAdd(e, this.state.type); }; @@ -104,8 +104,16 @@ class ObjectWidgetTopBar extends React.Component { if (types && types.size > 0) { return ( - + {types.map((type, idx) => ( + + ))} {addButton} @@ -116,11 +124,7 @@ class ObjectWidgetTopBar extends React.Component { } render() { - const { - onCollapseToggle, - collapsed, - heading = null, - } = this.props; + const { onCollapseToggle, collapsed, heading = null } = this.props; return ( diff --git a/packages/netlify-cms-widget-list/src/ListControl.js b/packages/netlify-cms-widget-list/src/ListControl.js index 696f80b7417f..6ab47a06546e 100644 --- a/packages/netlify-cms-widget-list/src/ListControl.js +++ b/packages/netlify-cms-widget-list/src/ListControl.js @@ -6,7 +6,7 @@ import { List, Map } from 'immutable'; import { partial } from 'lodash'; import { SortableContainer, SortableElement, SortableHandle } from 'react-sortable-hoc'; import { ObjectControl } from 'netlify-cms-widget-object'; -import { TYPES_KEY, getTypedFieldForValue, resolveFieldKeyType} from 'netlify-cms-lib-util'; +import { TYPES_KEY, getTypedFieldForValue, resolveFieldKeyType } from 'netlify-cms-lib-util'; import { ListItemTopBar, ObjectWidgetTopBar, @@ -58,7 +58,7 @@ const SortableList = SortableContainer(({ items, renderItem }) => { const valueTypes = { SINGLE: 'SINGLE', MULTIPLE: 'MULTIPLE', - MIXED: 'MIXED' + MIXED: 'MIXED', }; export default class ListControl extends React.Component { @@ -152,7 +152,7 @@ export default class ListControl extends React.Component { const { value, onChange } = this.props; let parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); if (this.getValueType() === valueTypes.MIXED && type) { - parsedValue = parsedValue.set(typeKey, type) + parsedValue = parsedValue.set(typeKey, type); } this.setState({ itemsCollapsed: this.state.itemsCollapsed.push(false) }); onChange((value || List()).push(parsedValue)); diff --git a/packages/netlify-cms-widget-object/src/ObjectPreview.js b/packages/netlify-cms-widget-object/src/ObjectPreview.js index e5f0cdce7d12..545a55014a7d 100644 --- a/packages/netlify-cms-widget-object/src/ObjectPreview.js +++ b/packages/netlify-cms-widget-object/src/ObjectPreview.js @@ -6,7 +6,7 @@ import { TYPES_KEY } from 'netlify-cms-lib-util'; const ObjectPreview = ({ field }) => (
    {field.get('label', field.get('name'))}
    - {(field && (field.get(TYPES_KEY)) || field.get('fields') || field.get('field')) || null} + {(field && (field.get(TYPES_KEY) || field.get('fields') || field.get('field'))) || null}     ); From 5b0d982e0c12a079d1670a952492e818fbfdcc98 Mon Sep 17 00:00:00 2001 From: smnh Date: Sat, 10 Nov 2018 14:38:47 +0200 Subject: [PATCH 4/8] Added error handling for typed lists - Added typed list example to kitchen sink --- dev-test/config.yml | 26 ++++++++++ dev-test/index.html | 2 +- .../EditorPreviewPane/EditorPreviewPane.js | 51 ++++++++++++------- packages/netlify-cms-lib-util/src/index.js | 5 +- .../src/{mixedWidget.js => typedList.js} | 14 ++++- .../src/ListControl.js | 32 +++++++++++- 6 files changed, 108 insertions(+), 22 deletions(-) rename packages/netlify-cms-lib-util/src/{mixedWidget.js => typedList.js} (61%) diff --git a/dev-test/config.yml b/dev-test/config.yml index 6eb9615be224..d91d8f1a36e3 100644 --- a/dev-test/config.yml +++ b/dev-test/config.yml @@ -195,3 +195,29 @@ collections: # A list of collections the CMS should be able to edit widget: 'select', options: ['a', 'b', 'c'], } + - label: 'Typed List' + name: 'typed_list' + widget: 'list' + types: + - label: 'Type 1 Object' + name: 'type_1_object' + widget: 'object' + fields: + - { label: 'String', name: 'string', widget: 'string' } + - { label: 'Boolean', name: 'boolean', widget: 'boolean' } + - { label: 'Text', name: 'text', widget: 'text' } + - label: 'Type 2 Object' + name: 'type_2_object' + widget: 'object' + fields: + - { label: 'Number', name: 'number', widget: 'number' } + - { label: 'Select', name: 'select', widget: 'select', options: ['a', 'b', 'c'] } + - { label: 'Datetime', name: 'datetime', widget: 'datetime' } + - { label: 'Markdown', name: 'markdown', widget: 'markdown' } + - label: 'Type 3 Object' + name: 'type_3_object' + widget: 'object' + fields: + - { label: 'Date', name: 'date', widget: 'date' } + - { label: 'Image', name: 'image', widget: 'image' } + - { label: 'File', name: 'file', widget: 'file' } diff --git a/dev-test/index.html b/dev-test/index.html index 2d1b5e40bd6b..ce736c1014db 100644 --- a/dev-test/index.html +++ b/dev-test/index.html @@ -44,7 +44,7 @@ }, _sink: { "a-big-entry-with-all-the-things.md": { - content: "---\ntitle: CHAPTER 1. Loomings.\nboolean: true\ntext: >-\n Call me Ishmael. Some years ago—never mind how long precisely—having little or\n no money in my purse, and nothing particular to interest me on shore, I\n thought I would sail about a little and see the watery part of the world. It\n is a way I have of driving off the spleen and regulating the circulation.\n Whenever I find myself growing grim about the mouth; whenever it is a damp,\n drizzly November in my soul; whenever I find myself involuntarily pausing\n before coffin warehouses, and bringing up the rear of every funeral I meet;\n and especially whenever my hypos get such an upper hand of me, that it\n requires a strong moral principle to prevent me from deliberately stepping\n into the street, and methodically knocking people’s hats off—then, I account\n it high time to get to sea as soon as I can. This is my substitute for pistol\n and ball. With a philosophical flourish Cato throws himself upon his sword; I\n quietly take to the ship. There is nothing surprising in this. If they but\n knew it, almost all men in their degree, some time or other, cherish very\n nearly the same feelings towards the ocean with me.\nnumber: '111111'\nmarkdown: \"# Call me Ishmael. Some years ago—never mind how long precisely—having little or no money in my purse, and nothing particular to interest me on shore, I thought I would sail about a little and see the watery part of the world. It is a way I have of driving off the spleen and regulating the circulation. Whenever I find myself growing grim about the mouth; whenever it is a damp, drizzly November in my soul; whenever I find myself involuntarily pausing before coffin warehouses, and bringing up the rear of every funeral I meet; and especially whenever my hypos get such an upper hand of me, that it requires a strong moral principle to prevent me from deliberately stepping into the street, and methodically knocking people’s hats off—then, I account it high time to get to sea as soon as I can. This is my substitute for pistol and ball. With a philosophical flourish Cato throws himself upon his sword; I quietly take to the ship. There is nothing surprising in this. If they but knew it, almost all men in their degree, some time or other, cherish very nearly the same feelings towards the ocean with me.\\n\\n## There now is your insular city of the Manhattoes, belted round by wharves as Indian isles by coral reefs—commerce surrounds it with her surf. Right and left, the streets take you waterward. Its extreme downtown is the battery, where that noble mole is washed by waves, and cooled by breezes, which a few hours previous were out of sight of land. Look at the crowds of water-gazers there.\\n\\n**Circumambulate the city of a dreamy Sabbath afternoon. Go from Corlears Hook to Coenties Slip, and from thence, by Whitehall, northward. What do you see?—Posted like silent sentinels all around the town, stand thousands upon thousands of mortal men fixed in ocean reveries. Some leaning against the spiles; some seated upon the pier-heads; some looking over the bulwarks of ships from China; some high aloft in the rigging, as if striving to get a still better seaward peep. But these are all landsmen; of week days pent up in lath and plaster—tied to counters, nailed to benches, clinched to desks. How then is this? Are the green fields gone? What do they here?**\\n\\n*But look! here come more crowds, pacing straight for the water, and seemingly bound for a dive. Strange! Nothing will content them but the extremest limit of the land; loitering under the shady lee of yonder warehouses will not suffice. No. They must get just as nigh the water as they possibly can without falling in. And there they stand—miles of them—leagues. Inlanders all, they come from lanes and alleys, streets and avenues—north, east, south, and west. Yet here they all unite. Tell me, does the magnetic virtue of the needles of the compasses of all those ships attract them thither?*\\n\\n[Once more. Say you are in the country; in some high land of lakes. Take almost any path you please, and ten to one it carries you down in a dale, and leaves you there by a pool in the stream. There is magic in it. Let the most absent-minded of men be plunged in his deepest reveries—stand that man on his legs, set his feet a-going, and he will infallibly lead you to water, if water there be in all that region. Should you ever be athirst in the great American desert, try this experiment, if your caravan happen to be supplied with a metaphysical professor. Yes, as every one knows, meditation and water are wedded for ever.](https://netlifycms.org)\\n\\n![moby dick](/moby-dick.jpg)\\n\\n{{< youtube lZ6NEHDgk58 >}}\\n\\nBut here is an artist. He desires to paint you the dreamiest, shadiest, quietest, most enchanting bit of romantic landscape in all the valley of the Saco. What is the chief element he employs? There stand his trees, each with a hollow trunk, as if a hermit and a crucifix were within; and here sleeps his meadow, and there sleep his cattle; and up from yonder cottage goes a sleepy smoke. Deep into distant woodlands winds a mazy way, reaching to overlapping spurs of mountains bathed in their hill-side blue. But though the picture lies thus tranced, and though this pine-tree shakes down its sighs like leaves upon this shepherd’s head, yet all were vain, unless the shepherd’s eye were fixed upon the magic stream before him. Go visit the Prairies in June, when for scores on scores of miles you wade knee-deep among Tiger-lilies—what is the one charm wanting?—Water—there is not a drop of water there! Were Niagara but a cataract of sand, would you travel your thousand miles to see it? Why did the poor poet of Tennessee, upon suddenly receiving two handfuls of silver, deliberate whether to buy him a coat, which he sadly needed, or invest his money in a pedestrian trip to Rockaway Beach? Why is almost every robust healthy boy with a robust healthy soul in him, at some time or other crazy to go to sea? Why upon your first voyage as a passenger, did you yourself feel such a mystical vibration, when first told that you and your ship were now out of sight of land? Why did the old Persians hold the sea holy? Why did the Greeks give it a separate deity, and own brother of Jove? Surely all this is not without meaning. And still deeper the meaning of that story of Narcissus, who because he could not grasp the tormenting, mild image he saw in the fountain, plunged into it and was drowned. But that same image, we ourselves see in all rivers and oceans. It is the image of the ungraspable phantom of life; and this is the key to it all.\\n\\nNow, when I say that I am in the habit of going to sea whenever I begin to grow hazy about the eyes, and begin to be over conscious of my lungs, I do not mean to have it inferred that I ever go to sea as a passenger. For to go as a passenger you must needs have a purse, and a purse is but a rag unless you have something in it. Besides, passengers get sea-sick—grow quarrelsome—don’t sleep of nights—do not enjoy themselves much, as a general thing;—no, I never go as a passenger; nor, though I am something of a salt, do I ever go to sea as a Commodore, or a Captain, or a Cook. I abandon the glory and distinction of such offices to those who like them. For my part, I abominate all honourable respectable toils, trials, and tribulations of every kind whatsoever. It is quite as much as I can do to take care of myself, without taking care of ships, barques, brigs, schooners, and what not. And as for going as cook,—though I confess there is considerable glory in that, a cook being a sort of officer on ship-board—yet, somehow, I never fancied broiling fowls;—though once broiled, judiciously buttered, and judgmatically salted and peppered, there is no one who will speak more respectfully, not to say reverentially, of a broiled fowl than I will. It is out of the idolatrous dotings of the old Egyptians upon broiled ibis and roasted river horse, that you see the mummies of those creatures in their huge bake-houses the pyramids.\\n\\nNo, when I go to sea, I go as a simple sailor, right before the mast, plumb down into the forecastle, aloft there to the royal mast-head. True, they rather order me about some, and make me jump from spar to spar, like a grasshopper in a May meadow. And at first, this sort of thing is unpleasant enough. It touches one’s sense of honour, particularly if you come of an old established family in the land, the Van Rensselaers, or Randolphs, or Hardicanutes. And more than all, if just previous to putting your hand into the tar-pot, you have been lording it as a country schoolmaster, making the tallest boys stand in awe of you. The transition is a keen one, I assure you, from a schoolmaster to a sailor, and requires a strong decoction of Seneca and the Stoics to enable you to grin and bear it. But even this wears off in time.\\n\\nWhat of it, if some old hunks of a sea-captain orders me to get a broom and sweep down the decks? What does that indignity amount to, weighed, I mean, in the scales of the New Testament? Do you think the archangel Gabriel thinks anything the less of me, because I promptly and respectfully obey that old hunks in that particular instance? Who ain’t a slave? Tell me that. Well, then, however the old sea-captains may order me about—however they may thump and punch me about, I have the satisfaction of knowing that it is all right; that everybody else is one way or other served in much the same way—either in a physical or metaphysical point of view, that is; and so the universal thump is passed round, and all hands should rub each other’s shoulder-blades, and be content.\\n\\nAgain, I always go to sea as a sailor, because they make a point of paying me for my trouble, whereas they never pay passengers a single penny that I ever heard of. On the contrary, passengers themselves must pay. And there is all the difference in the world between paying and being paid. The act of paying is perhaps the most uncomfortable infliction that the two orchard thieves entailed upon us. But\_*being paid*,—what will compare with it? The urbane activity with which a man receives money is really marvellous, considering that we so earnestly believe money to be the root of all earthly ills, and that on no account can a monied man enter heaven. Ah! how cheerfully we consign ourselves to perdition!\\n\\nFinally, I always go to sea as a sailor, because of the wholesome exercise and pure air of the fore-castle deck. For as in this world, head winds are far more prevalent than winds from astern (that is, if you never violate the Pythagorean maxim), so for the most part the Commodore on the quarter-deck gets his atmosphere at second hand from the sailors on the forecastle. He thinks he breathes it first; but not so. In much the same way do the commonalty lead their leaders in many other things, at the same time that the leaders little suspect it. But wherefore it was that after having repeatedly smelt the sea as a merchant sailor, I should now take it into my head to go on a whaling voyage; this the invisible police officer of the Fates, who has the constant surveillance of me, and secretly dogs me, and influences me in some unaccountable way—he can better answer than any one else. And, doubtless, my going on this whaling voyage, formed part of the grand programme of Providence that was drawn up a long time ago. It came in as a sort of brief interlude and solo between more extensive performances. I take it that this part of the bill must have run something like this:\\n\\n“*Grand Contested Election for the Presidency of the United States.*\_“WHALING VOYAGE BY ONE ISHMAEL. “BLOODY BATTLE IN AFFGHANISTAN.”\\n\\nThough I cannot tell why it was exactly that those stage managers, the Fates, put me down for this shabby part of a whaling voyage, when others were set down for magnificent parts in high tragedies, and short and easy parts in genteel comedies, and jolly parts in farces—though I cannot tell why this was exactly; yet, now that I recall all the circumstances, I think I can see a little into the springs and motives which being cunningly presented to me under various disguises, induced me to set about performing the part I did, besides cajoling me into the delusion that it was a choice resulting from my own unbiased freewill and discriminating judgment.\\n\\nChief among these motives was the overwhelming idea of the great whale himself. Such a portentous and mysterious monster roused all my curiosity. Then the wild and distant seas where he rolled his island bulk; the undeliverable, nameless perils of the whale; these, with all the attending marvels of a thousand Patagonian sights and sounds, helped to sway me to my wish. With other men, perhaps, such things would not have been inducements; but as for me, I am tormented with an everlasting itch for things remote. I love to sail forbidden seas, and land on barbarous coasts. Not ignoring what is good, I am quick to perceive a horror, and could still be social with it—would they let me—since it is but well to be on friendly terms with all the inmates of the place one lodges in.\\n\\nBy reason of these things, then, the whaling voyage was welcome; the great flood-gates of the wonder-world swung open, and in the wild conceits that swayed me to my purpose, two and two there floated into my inmost soul, endless processions of the whale, and, mid most of them all, one grand hooded phantom, like a snow hill in the air.\"\ndatetime: 2017-06-07T18:55:28.110Z\ndate: 2017-06-07T18:55:28.111Z\nimage: /moby-dick.jpg\nfile: /moby-dick.jpg\nselect: b\npost: 'This is a TOML front matter post'\nobject:\n boolean: true\n text: >-\n I stuffed a shirt or two into my old carpet-bag, tucked it under my arm, and\n started for Cape Horn and the Pacific. Quitting the good city of old\n Manhatto, I duly arrived in New Bedford. It was a Saturday night in\n December. Much was I disappointed upon learning that the little packet for\n Nantucket had already sailed, and that no way of reaching that place would\n offer, till the following Monday.\n number: '222222'\n markdown: >-\n # I stuffed a shirt or two into my old carpet-bag, tucked it under my arm,\n and started for Cape Horn and the Pacific. Quitting the good city of old\n Manhatto, I duly arrived in New Bedford. It was a Saturday night in\n December. Much was I disappointed upon learning that the little packet for\n Nantucket had already sailed, and that no way of reaching that place would\n offer, till the following Monday.\n\n\n ## As most young candidates for the pains and penalties of whaling stop at\n this same New Bedford, thence to embark on their voyage, it may as well be\n related that I, for one, had no idea of so doing. For my mind was made up to\n sail in no other than a Nantucket craft, because there was a fine,\n boisterous something about everything connected with that famous old island,\n which amazingly pleased me. Besides though New Bedford has of late been\n gradually monopolising the business of whaling, and though in this matter\n poor old Nantucket is now much behind her, yet Nantucket was her great\n original—the Tyre of this Carthage;—the place where the first dead American\n whale was stranded. Where else but from Nantucket did those aboriginal\n whalemen, the Red-Men, first sally out in canoes to give chase to the\n Leviathan? And where but from Nantucket, too, did that first adventurous\n little sloop put forth, partly laden with imported cobblestones—so goes the\n story—to throw at the whales, in order to discover when they were nigh\n enough to risk a harpoon from the bowsprit?\n\n\n **Now having a night, a day, and still another night following before me in\n New Bedford, ere I could embark for my destined port, it became a matter of\n concernment where I was to eat and sleep meanwhile. It was a very\n dubious-looking, nay, a very dark and dismal night, bitingly cold and\n cheerless. I knew no one in the place. With anxious grapnels I had sounded\n my pocket, and only brought up a few pieces of silver,—So, wherever you go,\n Ishmael, said I to myself, as I stood in the middle of a dreary street\n shouldering my bag, and comparing the gloom towards the north with the\n darkness towards the south—wherever in your wisdom you may conclude to lodge\n for the night, my dear Ishmael, be sure to inquire the price, and don’t be\n too particular.**\n\n\n *With halting steps I paced the streets, and passed the sign of “The Crossed\n Harpoons”—but it looked too expensive and jolly there. Further on, from the\n bright red windows of the “Sword-Fish Inn,” there came such fervent rays,\n that it seemed to have melted the packed snow and ice from before the house,\n for everywhere else the congealed frost lay ten inches thick in a hard,\n asphaltic pavement,—rather weary for me, when I struck my foot against the\n flinty projections, because from hard, remorseless service the soles of my\n boots were in a most miserable plight. Too expensive and jolly, again\n thought I, pausing one moment to watch the broad glare in the street, and\n hear the sounds of the tinkling glasses within. But go on, Ishmael, said I\n at last; don’t you hear? get away from before the door; your patched boots\n are stopping the way. So on I went. I now by instinct followed the streets\n that took me waterward, for there, doubtless, were the cheapest, if not the\n cheeriest inns.*\n\n\n [Such dreary streets! blocks of blackness, not houses, on either hand, and\n here and there a candle, like a candle moving about in a tomb. At this hour\n of the night, of the last day of the week, that quarter of the town proved\n all but deserted. But presently I came to a smoky light proceeding from a\n low, wide building, the door of which stood invitingly open. It had a\n careless look, as if it were meant for the uses of the public; so, entering,\n the first thing I did was to stumble over an ash-box in the porch. Ha!\n thought I, ha, as the flying particles almost choked me, are these ashes\n from that destroyed city, Gomorrah? But “The Crossed Harpoons,” and “The\n Sword-Fish?”—this, then must needs be the sign of “The Trap.” However, I\n picked myself up and hearing a loud voice within, pushed on and opened a\n second, interior door.](https://netlifycms.org)\n\n\n ![moby dick](/moby-dick.jpg)\n\n\n {{< youtube lZ6NEHDgk58 >}}\n\n\n It seemed the great Black Parliament sitting in Tophet. A hundred black\n faces turned round in their rows to peer; and beyond, a black Angel of Doom\n was beating a book in a pulpit. It was a negro church; and the preacher’s\n text was about the blackness of darkness, and the weeping and wailing and\n teeth-gnashing there. Ha, Ishmael, muttered I, backing out, Wretched\n entertainment at the sign of ‘The Trap!’\n\n\n Moving on, I at last came to a dim sort of light not far from the docks, and\n heard a forlorn creaking in the air; and looking up, saw a swinging sign\n over the door with a white painting upon it, faintly representing a tall\n straight jet of misty spray, and these words underneath—“The Spouter\n Inn:—Peter Coffin.”\n\n\n Coffin?—Spouter?—Rather ominous in that particular connexion, thought I. But\n it is a common name in Nantucket, they say, and I suppose this Peter here is\n an emigrant from there. As the light looked so dim, and the place, for the\n time, looked quiet enough, and the dilapidated little wooden house itself\n looked as if it might have been carted here from the ruins of some burnt\n district, and as the swinging sign had a poverty-stricken sort of creak to\n it, I thought that here was the very spot for cheap lodgings, and the best\n of pea coffee.\n\n\n It was a queer sort of place—a gable-ended old house, one side palsied as it\n were, and leaning over sadly. It stood on a sharp bleak corner, where that\n tempestuous wind Euroclydon kept up a worse howling than ever it did about\n poor Paul’s tossed craft. Euroclydon, nevertheless, is a mighty pleasant\n zephyr to any one in-doors, with his feet on the hob quietly toasting for\n bed. “In judging of that tempestuous wind called Euroclydon,” says an old\n writer—of whose works I possess the only copy extant—“it maketh a marvellous\n difference, whether thou lookest out at it from a glass window where the\n frost is all on the outside, or whether thou observest it from that sashless\n window, where the frost is on both sides, and of which the wight Death is\n the only glazier.” True enough, thought I, as this passage occurred to my\n mind—old black-letter, thou reasonest well. Yes, these eyes are windows, and\n this body of mine is the house. What a pity they didn’t stop up the chinks\n and the crannies though, and thrust in a little lint here and there. But\n it’s too late to make any improvements now. The universe is finished; the\n copestone is on, and the chips were carted off a million years ago. Poor\n Lazarus there, chattering his teeth against the curbstone for his pillow,\n and shaking off his tatters with his shiverings, he might plug up both ears\n with rags, and put a corn-cob into his mouth, and yet that would not keep\n out the tempestuous Euroclydon. Euroclydon! says old Dives, in his red\n silken wrapper—(he had a redder one afterwards) pooh, pooh! What a fine\n frosty night; how Orion glitters; what northern lights! Let them talk of\n their oriental summer climes of everlasting conservatories; give me the\n privilege of making my own summer with my own coals.\n\n\n But what thinks Lazarus? Can he warm his blue hands by holding them up to\n the grand northern lights? Would not Lazarus rather be in Sumatra than here?\n Would he not far rather lay him down lengthwise along the line of the\n equator; yea, ye gods! go down to the fiery pit itself, in order to keep out\n this frost?\n\n\n Now, that Lazarus should lie stranded there on the curbstone before the door\n of Dives, this is more wonderful than that an iceberg should be moored to\n one of the Moluccas. Yet Dives himself, he too lives like a Czar in an ice\n palace made of frozen sighs, and being a president of a temperance society,\n he only drinks the tepid tears of orphans.\n\n\n But no more of this blubbering now, we are going a-whaling, and there is\n plenty of that yet to come. Let us scrape the ice from our frosted feet, and\n see what sort of a place this “Spouter” may be.\n datetime: 2017-06-07T19:05:43.816Z\n date: 2017-06-07T18:55:28.115Z\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: b\n string: CHAPTER 2. The Carpet-Bag.\nlist:\n - text: >-\n Entering that gable-ended Spouter-Inn, you found yourself in a wide, low,\n straggling entry with old-fashioned wainscots, reminding one of the\n bulwarks of some condemned old craft. On one side hung a very large\n oilpainting so thoroughly besmoked, and every way defaced, that in the\n unequal crosslights by which you viewed it, it was only by diligent study\n and a series of systematic visits to it, and careful inquiry of the\n neighbors, that you could any way arrive at an understanding of its\n purpose. Such unaccountable masses of shades and shadows, that at first\n you almost thought some ambitious young artist, in the time of the New\n England hags, had endeavored to delineate chaos bewitched. But by dint of\n much and earnest contemplation, and oft repeated ponderings, and\n especially by throwing open the little window towards the back of the\n entry, you at last come to the conclusion that such an idea, however wild,\n might not be altogether unwarranted.\n number: '333333'\n markdown: \"# Entering that gable-ended Spouter-Inn, you found yourself in a wide, low, straggling entry with old-fashioned wainscots, reminding one of the bulwarks of some condemned old craft. On one side hung a very large oilpainting so thoroughly besmoked, and every way defaced, that in the unequal crosslights by which you viewed it, it was only by diligent study and a series of systematic visits to it, and careful inquiry of the neighbors, that you could any way arrive at an understanding of its purpose. Such unaccountable masses of shades and shadows, that at first you almost thought some ambitious young artist, in the time of the New England hags, had endeavored to delineate chaos bewitched. But by dint of much and earnest contemplation, and oft repeated ponderings, and especially by throwing open the little window towards the back of the entry, you at last come to the conclusion that such an idea, however wild, might not be altogether unwarranted.\n\n# But what most puzzled and confounded you was a long, limber, portentous, black mass of something hovering in the centre of the picture over three blue, dim, perpendicular lines floating in a nameless yeast. A boggy, soggy, squitchy picture truly, enough to drive a nervous man distracted. Yet was there a sort of indefinite, half-attained, unimaginable sublimity about it that fairly froze you to it, till you involuntarily took an oath with yourself to find out what that marvellous painting meant. Ever and anon a bright, but, alas, deceptive idea would dart you through.—It’s the Black Sea in a midnight gale.—It’s the unnatural combat of the four primal elements.—It’s a blasted heath.—It’s a Hyperborean winter scene.—It’s the breaking-up of the icebound stream of Time. But at last all these fancies yielded to that one portentous something in the picture’s midst.\_*That*\_once found out, and all the rest were plain. But stop; does it not bear a faint resemblance to a gigantic fish? even the great leviathan himself?\n\n## In fact, the artist’s design seemed this: a final theory of my own, partly based upon the aggregated opinions of many aged persons with whom I conversed upon the subject. The picture represents a Cape-Horner in a great hurricane; the half-foundered ship weltering there with its three dismantled masts alone visible; and an exasperated whale, purposing to spring clean over the craft, is in the enormous act of impaling himself upon the three mast-heads.\n\n## The opposite wall of this entry was hung all over with a heathenish array of monstrous clubs and spears. Some were thickly set with glittering teeth resembling ivory saws; others were tufted with knots of human hair; and one was sickle-shaped, with a vast handle sweeping round like the segment made in the new-mown grass by a long-armed mower. You shuddered as you gazed, and wondered what monstrous cannibal and savage could ever have gone a death-harvesting with such a hacking, horrifying implement. Mixed with these were rusty old whaling lances and harpoons all broken and deformed. Some were storied weapons. With this once long lance, now wildly elbowed, fifty years ago did Nathan Swain kill fifteen whales between a sunrise and a sunset. And that harpoon—so like a corkscrew now—was flung in Javan seas, and run away with by a whale, years afterwards slain off the Cape of Blanco. The original iron entered nigh the tail, and, like a restless needle sojourning in the body of a man, travelled full forty feet, and at last was found imbedded in the hump.\n\nCrossing this dusky entry, and on through yon low-arched way—cut through what in old times must have been a great central chimney with fireplaces all round—you enter the public room. A still duskier place is this, with such low ponderous beams above, and such old wrinkled planks beneath, that you would almost fancy you trod some old craft’s cockpits, especially of such a howling night, when this corner-anchored old ark rocked so furiously. On one side stood a long, low, shelf-like table covered with cracked glass cases, filled with dusty rarities gathered from this wide world’s remotest nooks. Projecting from the further angle of the room stands a dark-looking den—the bar—a rude attempt at a right whale’s head. Be that how it may, there stands the vast arched bone of the whale’s jaw, so wide, a coach might almost drive beneath it. Within are shabby shelves, ranged round with old decanters, bottles, flasks; and in those jaws of swift destruction, like another cursed Jonah (by which name indeed they called him), bustles a little withered old man, who, for their money, dearly sells the sailors deliriums and death.\n\nAbominable are the tumblers into which he pours his poison. Though true cylinders without—within, the villanous green goggling glasses deceitfully tapered downwards to a cheating bottom. Parallel meridians rudely pecked into the glass, surround these footpads’ goblets. Fill to\_*this*\_mark, and your charge is but a penny; to\_*this*\_a penny more; and so on to the full glass—the Cape Horn measure, which you may gulp down for a shilling.\n\nUpon entering the place I found a number of young seamen gathered about a table, examining by a dim light divers specimens of\_*skrimshander*. I sought the landlord, and telling him I desired to be accommodated with a room, received for answer that his house was full—not a bed unoccupied. “But avast,” he added, tapping his forehead, “you haint no objections to sharing a harpooneer’s blanket, have ye? I s’pose you are goin’ a-whalin’, so you’d better get used to that sort of thing.”\n\nI told him that I never liked to sleep two in a bed; that if I should ever do so, it would depend upon who the harpooneer might be, and that if he (the landlord) really had no other place for me, and the harpooneer was not decidedly objectionable, why rather than wander further about a strange town on so bitter a night, I would put up with the half of any decent man’s blanket.\n\n“I thought so. All right; take a seat. Supper?—you want supper? Supper’ll be ready directly.”\n\nI sat down on an old wooden settle, carved all over like a bench on the Battery. At one end a ruminating tar was still further adorning it with his jack-knife, stooping over and diligently working away at the space between his legs. He was trying his hand at a ship under full sail, but he didn’t make much headway, I thought.\n\nAt last some four or five of us were summoned to our meal in an adjoining room. It was cold as Iceland—no fire at all—the landlord said he couldn’t afford it. Nothing but two dismal tallow candles, each in a winding sheet. We were fain to button up our monkey jackets, and hold to our lips cups of scalding tea with our half frozen fingers. But the fare was of the most substantial kind—not only meat and potatoes, but dumplings; good heavens! dumplings for supper! One young fellow in a green box coat, addressed himself to these dumplings in a most direful manner.\n\n“My boy,” said the landlord, “you’ll have the nightmare to a dead sartainty.”\n\n“Landlord,” I whispered, “that aint the harpooneer is it?”\n\n“Oh, no,” said he, looking a sort of diabolically funny, “the harpooneer is a dark complexioned chap. He never eats dumplings, he don’t—he eats nothing but steaks, and he likes ‘em rare.”\n\n“The devil he does,” says I. “Where is that harpooneer? Is he here?”\n\n“He’ll be here afore long,” was the answer.\n\nI could not help it, but I began to feel suspicious of this “dark complexioned” harpooneer. At any rate, I made up my mind that if it so turned out that we should sleep together, he must undress and get into bed before I did.\n\nSupper over, the company went back to the bar-room, when, knowing not what else to do with myself, I resolved to spend the rest of the evening as a looker on.\n\nPresently a rioting noise was heard without. Starting up, the landlord cried, “That’s the Grampus’s crew. I seed her reported in the offing this morning; a three years’ voyage, and a full ship. Hurrah, boys; now we’ll have the latest news from the Feegees.”\n\nA tramping of sea boots was heard in the entry; the door was flung open, and in rolled a wild set of mariners enough. Enveloped in their shaggy watch coats, and with their heads muffled in woollen comforters, all bedarned and ragged, and their beards stiff with icicles, they seemed an eruption of bears from Labrador. They had just landed from their boat, and this was the first house they entered. No wonder, then, that they made a straight wake for the whale’s mouth—the bar—when the wrinkled little old Jonah, there officiating, soon poured them out brimmers all round. One complained of a bad cold in his head, upon which Jonah mixed him a pitch-like potion of gin and molasses, which he swore was a sovereign cure for all colds and catarrhs whatsoever, never mind of how long standing, or whether caught off the coast of Labrador, or on the weather side of an ice-island.\n\nThe liquor soon mounted into their heads, as it generally does even with the arrantest topers newly landed from sea, and they began capering about most obstreperously.\n\nI observed, however, that one of them held somewhat aloof, and though he seemed desirous not to spoil the hilarity of his shipmates by his own sober face, yet upon the whole he refrained from making as much noise as the rest. This man interested me at once; and since the sea-gods had ordained that he should soon become my shipmate (though but a sleeping-partner one, so far as this narrative is concerned), I will here venture upon a little description of him. He stood full six feet in height, with noble shoulders, and a chest like a coffer-dam. I have seldom seen such brawn in a man. His face was deeply brown and burnt, making his white teeth dazzling by the contrast; while in the deep shadows of his eyes floated some reminiscences that did not seem to give him much joy. His voice at once announced that he was a Southerner, and from his fine stature, I thought he must be one of those tall mountaineers from the Alleghanian Ridge in Virginia. When the revelry of his companions had mounted to its height, this man slipped away unobserved, and I saw no more of him till he became my comrade on the sea. In a few minutes, however, he was missed by his shipmates, and being, it seems, for some reason a huge favourite with them, they raised a cry of “Bulkington! Bulkington! where’s Bulkington?” and darted out of the house in pursuit of him.\n\nIt was now about nine o’clock, and the room seeming almost supernaturally quiet after these orgies, I began to congratulate myself upon a little plan that had occurred to me just previous to the entrance of the seamen.\n\nNo man prefers to sleep two in a bed. In fact, you would a good deal rather not sleep with your own brother. I don’t know how it is, but people like to be private when they are sleeping. And when it comes to sleeping with an unknown stranger, in a strange inn, in a strange town, and that stranger a harpooneer, then your objections indefinitely multiply. Nor was there any earthly reason why I as a sailor should sleep two in a bed, more than anybody else; for sailors no more sleep two in a bed at sea, than bachelor Kings do ashore. To be sure they all sleep together in one apartment, but you have your own hammock, and cover yourself with your own blanket, and sleep in your own skin.\n\nThe more I pondered over this harpooneer, the more I abominated the thought of sleeping with him. It was fair to presume that being a harpooneer, his linen or woollen, as the case might be, would not be of the tidiest, certainly none of the finest. I began to twitch all over. Besides, it was getting late, and my decent harpooneer ought to be home and going bedwards. Suppose now, he should tumble in upon me at midnight—how could I tell from what vile hole he had been coming?\n\n“Landlord! I’ve changed my mind about that harpooneer.—I shan’t sleep with him. I’ll try the bench here.”\n\n“Just as you please; I’m sorry I can’t spare ye a tablecloth for a mattress, and it’s a plaguy rough board here”—feeling of the knots and notches. “But wait a bit, Skrimshander; I’ve got a carpenter’s plane there in the bar—wait, I say, and I’ll make ye snug enough.” So saying he procured the plane; and with his old silk handkerchief first dusting the bench, vigorously set to planing away at my bed, the while grinning like an ape. The shavings flew right and left; till at last the plane-iron came bump against an indestructible knot. The landlord was near spraining his wrist, and I told him for heaven’s sake to quit—the bed was soft enough to suit me, and I did not know how all the planing in the world could make eider down of a pine plank. So gathering up the shavings with another grin, and throwing them into the great stove in the middle of the room, he went about his business, and left me in a brown study.\n\nI now took the measure of the bench, and found that it was a foot too short; but that could be mended with a chair. But it was a foot too narrow, and the other bench in the room was about four inches higher than the planned one—so there was no yoking them. I then placed the first bench lengthwise along the only clear space against the wall, leaving a little interval between, for my back to settle down in. But I soon found that there came such a draught of cold air over me from under the sill of the window, that this plan would never do at all, especially as another current from the rickety door met the one from the window, and both together formed a series of small whirlwinds in the immediate vicinity of the spot where I had thought to spend the night.\n\nThe devil fetch that harpooneer, thought I, but stop, couldn’t I steal a march on him—bolt his door inside, and jump into his bed, not to be wakened by the most violent knockings? It seemed no bad idea; but upon second thoughts I dismissed it. For who could tell but what the next morning, so soon as I popped out of the room, the harpooneer might be standing in the entry, all ready to knock me down!\n\nStill, looking round me again, and seeing no possible chance of spending a sufferable night unless in some other person’s bed, I began to think that after all I might be cherishing unwarrantable prejudices against this unknown harpooneer. Thinks I, I’ll wait awhile; he must be dropping in before long. I’ll have a good look at him then, and perhaps we may become jolly good bedfellows after all—there’s no telling.\n\nBut though the other boarders kept coming in by ones, twos, and threes, and going to bed, yet no sign of my harpooneer.\n\n“Landlord!” said I, “what sort of a chap is he—does he always keep such late hours?” It was now hard upon twelve o’clock.\n\nThe landlord chuckled again with his lean chuckle, and seemed to be mightily tickled at something beyond my comprehension. “No,” he answered, “generally he’s an early bird—airley to bed and airley to rise—yes, he’s the bird what catches the worm. But to-night he went out a peddling, you see, and I don’t see what on airth keeps him so late, unless, may be, he can’t sell his head.”\n\n“Can’t sell his head?—What sort of a bamboozingly story is this you are telling me?” getting into a towering rage. “Do you pretend to say, landlord, that this harpooneer is actually engaged this blessed Saturday night, or rather Sunday morning, in peddling his head around this town?”\n\n“That’s precisely it,” said the landlord, “and I told him he couldn’t sell it here, the market’s overstocked.”\n\n“With what?” shouted I.\n\n“With heads to be sure; ain’t there too many heads in the world?”\n\n“I tell you what it is, landlord,” said I quite calmly, “you’d better stop spinning that yarn to me—I’m not green.”\n\n“May be not,” taking out a stick and whittling a toothpick, “but I rayther guess you’ll be done\_*brown*\_if that ere harpooneer hears you a slanderin’ his head.”\n\n“I’ll break it for him,” said I, now flying into a passion again at this unaccountable farrago of the landlord’s.\n\n“It’s broke a’ready,” said he.\n\n“Broke,” said I—“*broke*, do you mean?”\n\n“Sartain, and that’s the very reason he can’t sell it, I guess.”\n\n“Landlord,” said I, going up to him as cool as Mt. Hecla in a snow-storm—“landlord, stop whittling. You and I must understand one another, and that too without delay. I come to your house and want a bed; you tell me you can only give me half a one; that the other half belongs to a certain harpooneer. And about this harpooneer, whom I have not yet seen, you persist in telling me the most mystifying and exasperating stories tending to beget in me an uncomfortable feeling towards the man whom you design for my bedfellow—a sort of connexion, landlord, which is an intimate and confidential one in the highest degree. I now demand of you to speak out and tell me who and what this harpooneer is, and whether I shall be in all respects safe to spend the night with him. And in the first place, you will be so good as to unsay that story about selling his head, which if true I take to be good evidence that this harpooneer is stark mad, and I’ve no idea of sleeping with a madman; and you, sir,\_*you*\_I mean, landlord,\_*you*, sir, by trying to induce me to do so knowingly, would thereby render yourself liable to a criminal prosecution.”\n\n“Wall,” said the landlord, fetching a long breath, “that’s a purty long sarmon for a chap that rips a little now and then. But be easy, be easy, this here harpooneer I have been tellin’ you of has just arrived from the south seas, where he bought up a lot of ‘balmed New Zealand heads (great curios, you know), and he’s sold all on ‘em but one, and that one he’s trying to sell to-night, cause to-morrow’s Sunday, and it would not do to be sellin’ human heads about the streets when folks is goin’ to churches. He wanted to, last Sunday, but I stopped him just as he was goin’ out of the door with four heads strung on a string, for all the airth like a string of inions.”\n\nThis account cleared up the otherwise unaccountable mystery, and showed that the landlord, after all, had had no idea of fooling me—but at the same time what could I think of a harpooneer who stayed out of a Saturday night clean into the holy Sabbath, engaged in such a cannibal business as selling the heads of dead idolators?\n\n“Depend upon it, landlord, that harpooneer is a dangerous man.”\n\n“He pays reg’lar,” was the rejoinder. “But come, it’s getting dreadful late, you had better be turning flukes—it’s a nice bed; Sal and me slept in that ere bed the night we were spliced. There’s plenty of room for two to kick about in that bed; it’s an almighty big bed that. Why, afore we give it up, Sal used to put our Sam and little Johnny in the foot of it. But I got a dreaming and sprawling about one night, and somehow, Sam got pitched on the floor, and came near breaking his arm. Arter that, Sal said it wouldn’t do. Come along here, I’ll give ye a glim in a jiffy;” and so saying he lighted a candle and held it towards me, offering to lead the way. But I stood irresolute; when looking at a clock in the corner, he exclaimed “I vum it’s Sunday—you won’t see that harpooneer to-night; he’s come to anchor somewhere—come along then;\_*do*\_come;\_*won’t*\_ye come?”\n\nI considered the matter a moment, and then up stairs we went, and I was ushered into a small room, cold as a clam, and furnished, sure enough, with a prodigious bed, almost big enough indeed for any four harpooneers to sleep abreast.\n\n“There,” said the landlord, placing the candle on a crazy old sea chest that did double duty as a wash-stand and centre table; “there, make yourself comfortable now, and good night to ye.” I turned round from eyeing the bed, but he had disappeared.\n\nFolding back the counterpane, I stooped over the bed. Though none of the most elegant, it yet stood the scrutiny tolerably well. I then glanced round the room; and besides the bedstead and centre table, could see no other furniture belonging to the place, but a rude shelf, the four walls, and a papered fireboard representing a man striking a whale. Of things not properly belonging to the room, there was a hammock lashed up, and thrown upon the floor in one corner; also a large seaman’s bag, containing the harpooneer’s wardrobe, no doubt in lieu of a land trunk. Likewise, there was a parcel of outlandish bone fish hooks on the shelf over the fire-place, and a tall harpoon standing at the head of the bed.\n\nBut what is this on the chest? I took it up, and held it close to the light, and felt it, and smelt it, and tried every way possible to arrive at some satisfactory conclusion concerning it. I can compare it to nothing but a large door mat, ornamented at the edges with little tinkling tags something like the stained porcupine quills round an Indian moccasin. There was a hole or slit in the middle of this mat, as you see the same in South American ponchos. But could it be possible that any sober harpooneer would get into a door mat, and parade the streets of any Christian town in that sort of guise? I put it on, to try it, and it weighed me down like a hamper, being uncommonly shaggy and thick, and I thought a little damp, as though this mysterious harpooneer had been wearing it of a rainy day. I went up in it to a bit of glass stuck against the wall, and I never saw such a sight in my life. I tore myself out of it in such a hurry that I gave myself a kink in the neck.\n\nI sat down on the side of the bed, and commenced thinking about this head-peddling harpooneer, and his door mat. After thinking some time on the bed-side, I got up and took off my monkey jacket, and then stood in the middle of the room thinking. I then took off my coat, and thought a little more in my shirt sleeves. But beginning to feel very cold now, half undressed as I was, and remembering what the landlord said about the harpooneer’s not coming home at all that night, it being so very late, I made no more ado, but jumped out of my pantaloons and boots, and then blowing out the light tumbled into bed, and commended myself to the care of heaven.\n\nWhether that mattress was stuffed with corn-cobs or broken crockery, there is no telling, but I rolled about a good deal, and could not sleep for a long time. At last I slid off into a light doze, and had pretty nearly made a good offing towards the land of Nod, when I heard a heavy footfall in the passage, and saw a glimmer of light come into the room from under the door.\n\nLord save me, thinks I, that must be the harpooneer, the infernal head-peddler. But I lay perfectly still, and resolved not to say a word till spoken to. Holding a light in one hand, and that identical New Zealand head in the other, the stranger entered the room, and without looking towards the bed, placed his candle a good way off from me on the floor in one corner, and then began working away at the knotted cords of the large bag I before spoke of as being in the room. I was all eagerness to see his face, but he kept it averted for some time while employed in unlacing the bag’s mouth. This accomplished, however, he turned round—when, good heavens! what a sight! Such a face! It was of a dark, purplish, yellow colour, here and there stuck over with large blackish looking squares. Yes, it’s just as I thought, he’s a terrible bedfellow; he’s been in a fight, got dreadfully cut, and here he is, just from the surgeon. But at that moment he chanced to turn his face so towards the light, that I plainly saw they could not be sticking-plasters at all, those black squares on his cheeks. They were stains of some sort or other. At first I knew not what to make of this; but soon an inkling of the truth occurred to me. I remembered a story of a white man—a whaleman too—who, falling among the cannibals, had been tattooed by them. I concluded that this harpooneer, in the course of his distant voyages, must have met with a similar adventure. And what is it, thought I, after all! It’s only his outside; a man can be honest in any sort of skin. But then, what to make of his unearthly complexion, that part of it, I mean, lying round about, and completely independent of the squares of tattooing. To be sure, it might be nothing but a good coat of tropical tanning; but I never heard of a hot sun’s tanning a white man into a purplish yellow one. However, I had never been in the South Seas; and perhaps the sun there produced these extraordinary effects upon the skin. Now, while all these ideas were passing through me like lightning, this harpooneer never noticed me at all. But, after some difficulty having opened his bag, he commenced fumbling in it, and presently pulled out a sort of tomahawk, and a seal-skin wallet with the hair on. Placing these on the old chest in the middle of the room, he then took the New Zealand head—a ghastly thing enough—and crammed it down into the bag. He now took off his hat—a new beaver hat—when I came nigh singing out with fresh surprise. There was no hair on his head—none to speak of at least—nothing but a small scalp-knot twisted up on his forehead. His bald purplish head now looked for all the world like a mildewed skull. Had not the stranger stood between me and the door, I would have bolted out of it quicker than ever I bolted a dinner.\n\nEven as it was, I thought something of slipping out of the window, but it was the second floor back. I am no coward, but what to make of this head-peddling purple rascal altogether passed my comprehension. Ignorance is the parent of fear, and being completely nonplussed and confounded about the stranger, I confess I was now as much afraid of him as if it was the devil himself who had thus broken into my room at the dead of night. In fact, I was so afraid of him that I was not game enough just then to address him, and demand a satisfactory answer concerning what seemed inexplicable in him.\n\nMeanwhile, he continued the business of undressing, and at last showed his chest and arms. As I live, these covered parts of him were checkered with the same squares as his face; his back, too, was all over the same dark squares; he seemed to have been in a Thirty Years’ War, and just escaped from it with a sticking-plaster shirt. Still more, his very legs were marked, as if a parcel of dark green frogs were running up the trunks of young palms. It was now quite plain that he must be some abominable savage or other shipped aboard of a whaleman in the South Seas, and so landed in this Christian country. I quaked to think of it. A peddler of heads too—perhaps the heads of his own brothers. He might take a fancy to mine—heavens! look at that tomahawk!\n\nBut there was no time for shuddering, for now the savage went about something that completely fascinated my attention, and convinced me that he must indeed be a heathen. Going to his heavy grego, or wrapall, or dreadnaught, which he had previously hung on a chair, he fumbled in the pockets, and produced at length a curious little deformed image with a hunch on its back, and exactly the colour of a three days’ old Congo baby. Remembering the embalmed head, at first I almost thought that this black manikin was a real baby preserved in some similar manner. But seeing that it was not at all limber, and that it glistened a good deal like polished ebony, I concluded that it must be nothing but a wooden idol, which indeed it proved to be. For now the savage goes up to the empty fire-place, and removing the papered fire-board, sets up this little hunch-backed image, like a tenpin, between the andirons. The chimney jambs and all the bricks inside were very sooty, so that I thought this fire-place made a very appropriate little shrine or chapel for his Congo idol.\n\nI now screwed my eyes hard towards the half hidden image, feeling but ill at ease meantime—to see what was next to follow. First he takes about a double handful of shavings out of his grego pocket, and places them carefully before the idol; then laying a bit of ship biscuit on top and applying the flame from the lamp, he kindled the shavings into a sacrificial blaze. Presently, after many hasty snatches into the fire, and still hastier withdrawals of his fingers (whereby he seemed to be scorching them badly), he at last succeeded in drawing out the biscuit; then blowing off the heat and ashes a little, he made a polite offer of it to the little negro. But the little devil did not seem to fancy such dry sort of fare at all; he never moved his lips. All these strange antics were accompanied by still stranger guttural noises from the devotee, who seemed to be praying in a sing-song or else singing some pagan psalmody or other, during which his face twitched about in the most unnatural manner. At last extinguishing the fire, he took the idol up very unceremoniously, and bagged it again in his grego pocket as carelessly as if he were a sportsman bagging a dead woodcock.\n\nAll these queer proceedings increased my uncomfortableness, and seeing him now exhibiting strong symptoms of concluding his business operations, and jumping into bed with me, I thought it was high time, now or never, before the light was put out, to break the spell in which I had so long been bound.\n\nBut the interval I spent in deliberating what to say, was a fatal one. Taking up his tomahawk from the table, he examined the head of it for an instant, and then holding it to the light, with his mouth at the handle, he puffed out great clouds of tobacco smoke. The next moment the light was extinguished, and this wild cannibal, tomahawk between his teeth, sprang into bed with me. I sang out, I could not help it now; and giving a sudden grunt of astonishment he began feeling me.\n\nStammering out something, I knew not what, I rolled away from him against the wall, and then conjured him, whoever or whatever he might be, to keep quiet, and let me get up and light the lamp again. But his guttural responses satisfied me at once that he but ill comprehended my meaning.\n\n“Who-e debel you?”—he at last said—“you no speak-e, dam-me, I kill-e.” And so saying the lighted tomahawk began flourishing about me in the dark.\n\n“Landlord, for God’s sake, Peter Coffin!” shouted I. “Landlord! Watch! Coffin! Angels! save me!”\n\n“Speak-e! tell-ee me who-ee be, or dam-me, I kill-e!” again growled the cannibal, while his horrid flourishings of the tomahawk scattered the hot tobacco ashes about me till I thought my linen would get on fire. But thank heaven, at that moment the landlord came into the room light in hand, and leaping from the bed I ran up to him.\n\n“Don’t be afraid now,” said he, grinning again, “Queequeg here wouldn’t harm a hair of your head.”\n\n“Stop your grinning,” shouted I, “and why didn’t you tell me that that infernal harpooneer was a cannibal?”\n\n“I thought ye know’d it;—didn’t I tell ye, he was a peddlin’ heads around town?—but turn flukes again and go to sleep. Queequeg, look here—you sabbee me, I sabbee—you this man sleepe you—you sabbee?”\n\n“Me sabbee plenty”—grunted Queequeg, puffing away at his pipe and sitting up in bed.\n\n“You gettee in,” he added, motioning to me with his tomahawk, and throwing the clothes to one side. He really did this in not only a civil but a really kind and charitable way. I stood looking at him a moment. For all his tattooings he was on the whole a clean, comely looking cannibal. What’s all this fuss I have been making about, thought I to myself—the man’s a human being just as I am: he has just as much reason to fear me, as I have to be afraid of him. Better sleep with a sober cannibal than a drunken Christian.\n\n“Landlord,” said I, “tell him to stash his tomahawk there, or pipe, or whatever you call it; tell him to stop smoking, in short, and I will turn in with him. But I don’t fancy having a man smoking in bed with me. It’s dangerous. Besides, I ain’t insured.”\n\nThis being told to Queequeg, he at once complied, and again politely motioned me to get into bed—rolling over to one side as much as to say—“I won’t touch a leg of ye.”\n\n“Good night, landlord,” said I, “you may go.”\n\nI turned in, and never slept better in my life.\"\n datetime: 2017-06-02T00:00:00-04:00\n date: 2017-06-07T00:00:00-04:00\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: c\n object:\n text: >-\n Upon waking next morning about daylight, I found Queequeg’s arm thrown\n over me in the most loving and affectionate manner. You had almost\n thought I had been his wife. The counterpane was of patchwork, full of\n odd little parti-coloured squares and triangles; and this arm of his\n tattooed all over with an interminable Cretan labyrinth of a figure, no\n two parts of which were of one precise shade—owing I suppose to his\n keeping his arm at sea unmethodically in sun and shade, his shirt\n sleeves irregularly rolled up at various times—this same arm of his, I\n say, looked for all the world like a strip of that same patchwork quilt.\n Indeed, partly lying on it as the arm did when I first awoke, I could\n hardly tell it from the quilt, they so blended their hues together; and\n it was only by the sense of weight and pressure that I could tell that\n Queequeg was hugging me.\n number: '444444'\n markdown: >-\n # Upon waking next morning about daylight, I found Queequeg’s arm thrown\n over me in the most loving and affectionate manner. You had almost\n thought I had been his wife. The counterpane was of patchwork, full of\n odd little parti-coloured squares and triangles; and this arm of his\n tattooed all over with an interminable Cretan labyrinth of a figure, no\n two parts of which were of one precise shade—owing I suppose to his\n keeping his arm at sea unmethodically in sun and shade, his shirt\n sleeves irregularly rolled up at various times—this same arm of his, I\n say, looked for all the world like a strip of that same patchwork quilt.\n Indeed, partly lying on it as the arm did when I first awoke, I could\n hardly tell it from the quilt, they so blended their hues together; and\n it was only by the sense of weight and pressure that I could tell that\n Queequeg was hugging me.\n\n\n ## My sensations were strange. Let me try to explain them. When I was a\n child, I well remember a somewhat similar circumstance that befell me;\n whether it was a reality or a dream, I never could entirely settle. The\n circumstance was this. I had been cutting up some caper or other—I think\n it was trying to crawl up the chimney, as I had seen a little sweep do a\n few days previous; and my stepmother who, somehow or other, was all the\n time whipping me, or sending me to bed supperless,—my mother dragged me\n by the legs out of the chimney and packed me off to bed, though it was\n only two o’clock in the afternoon of the 21st June, the longest day in\n the year in our hemisphere. I felt dreadfully. But there was no help for\n it, so up stairs I went to my little room in the third floor, undressed\n myself as slowly as possible so as to kill time, and with a bitter sigh\n got between the sheets.\n\n\n I lay there dismally calculating that sixteen entire hours must elapse\n before I could hope for a resurrection. Sixteen hours in bed! the small\n of my back ached to think of it. And it was so light too; the sun\n shining in at the window, and a great rattling of coaches in the\n streets, and the sound of gay voices all over the house. I felt worse\n and worse—at last I got up, dressed, and softly going down in my\n stockinged feet, sought out my stepmother, and suddenly threw myself at\n her feet, beseeching her as a particular favour to give me a good\n slippering for my misbehaviour; anything indeed but condemning me to lie\n abed such an unendurable length of time. But she was the best and most\n conscientious of stepmothers, and back I had to go to my room. For\n several hours I lay there broad awake, feeling a great deal worse than I\n have ever done since, even from the greatest subsequent misfortunes. At\n last I must have fallen into a troubled nightmare of a doze; and slowly\n waking from it—half steeped in dreams—I opened my eyes, and the before\n sun-lit room was now wrapped in outer darkness. Instantly I felt a shock\n running through all my frame; nothing was to be seen, and nothing was to\n be heard; but a supernatural hand seemed placed in mine. My arm hung\n over the counterpane, and the nameless, unimaginable, silent form or\n phantom, to which the hand belonged, seemed closely seated by my\n bed-side. For what seemed ages piled on ages, I lay there, frozen with\n the most awful fears, not daring to drag away my hand; yet ever thinking\n that if I could but stir it one single inch, the horrid spell would be\n broken. I knew not how this consciousness at last glided away from me;\n but waking in the morning, I shudderingly remembered it all, and for\n days and weeks and months afterwards I lost myself in confounding\n attempts to explain the mystery. Nay, to this very hour, I often puzzle\n myself with it.\n\n\n Now, take away the awful fear, and my sensations at feeling the\n supernatural hand in mine were very similar, in their strangeness, to\n those which I experienced on waking up and seeing Queequeg’s pagan arm\n thrown round me. But at length all the past night’s events soberly\n recurred, one by one, in fixed reality, and then I lay only alive to the\n comical predicament. For though I tried to move his arm—unlock his\n bridegroom clasp—yet, sleeping as he was, he still hugged me tightly, as\n though naught but death should part us twain. I now strove to rouse\n him—“Queequeg!”—but his only answer was a snore. I then rolled over, my\n neck feeling as if it were in a horse-collar; and suddenly felt a slight\n scratch. Throwing aside the counterpane, there lay the tomahawk sleeping\n by the savage’s side, as if it were a hatchet-faced baby. A pretty\n pickle, truly, thought I; abed here in a strange house in the broad day,\n with a cannibal and a tomahawk! “Queequeg!—in the name of goodness,\n Queequeg, wake!” At length, by dint of much wriggling, and loud and\n incessant expostulations upon the unbecomingness of his hugging a fellow\n male in that matrimonial sort of style, I succeeded in extracting a\n grunt; and presently, he drew back his arm, shook himself all over like\n a Newfoundland dog just from the water, and sat up in bed, stiff as a\n pike-staff, looking at me, and rubbing his eyes as if he did not\n altogether remember how I came to be there, though a dim consciousness\n of knowing something about me seemed slowly dawning over him. Meanwhile,\n I lay quietly eyeing him, having no serious misgivings now, and bent\n upon narrowly observing so curious a creature. When, at last, his mind\n seemed made up touching the character of his bedfellow, and he became,\n as it were, reconciled to the fact; he jumped out upon the floor, and by\n certain signs and sounds gave me to understand that, if it pleased me,\n he would dress first and then leave me to dress afterwards, leaving the\n whole apartment to myself. Thinks I, Queequeg, under the circumstances,\n this is a very civilized overture; but, the truth is, these savages have\n an innate sense of delicacy, say what you will; it is marvellous how\n essentially polite they are. I pay this particular compliment to\n Queequeg, because he treated me with so much civility and consideration,\n while I was guilty of great rudeness; staring at him from the bed, and\n watching all his toilette motions; for the time my curiosity getting the\n better of my breeding. Nevertheless, a man like Queequeg you don’t see\n every day, he and his ways were well worth unusual regarding.\n\n\n He commenced dressing at top by donning his beaver hat, a very tall one,\n by the by, and then—still minus his trowsers—he hunted up his boots.\n What under the heavens he did it for, I cannot tell, but his next\n movement was to crush himself—boots in hand, and hat on—under the bed;\n when, from sundry violent gaspings and strainings, I inferred he was\n hard at work booting himself; though by no law of propriety that I ever\n heard of, is any man required to be private when putting on his boots.\n But Queequeg, do you see, was a creature in the transition stage—neither\n caterpillar nor butterfly. He was just enough civilized to show off his\n outlandishness in the strangest possible manners. His education was not\n yet completed. He was an undergraduate. If he had not been a small\n degree civilized, he very probably would not have troubled himself with\n boots at all; but then, if he had not been still a savage, he never\n would have dreamt of getting under the bed to put them on. At last, he\n emerged with his hat very much dented and crushed down over his eyes,\n and began creaking and limping about the room, as if, not being much\n accustomed to boots, his pair of damp, wrinkled cowhide ones—probably\n not made to order either—rather pinched and tormented him at the first\n go off of a bitter cold morning.\n\n\n Seeing, now, that there were no curtains to the window, and that the\n street being very narrow, the house opposite commanded a plain view into\n the room, and observing more and more the indecorous figure that\n Queequeg made, staving about with little else but his hat and boots on;\n I begged him as well as I could, to accelerate his toilet somewhat, and\n particularly to get into his pantaloons as soon as possible. He\n complied, and then proceeded to wash himself. At that time in the\n morning any Christian would have washed his face; but Queequeg, to my\n amazement, contented himself with restricting his ablutions to his\n chest, arms, and hands. He then donned his waistcoat, and taking up a\n piece of hard soap on the wash-stand centre table, dipped it into water\n and commenced lathering his face. I was watching to see where he kept\n his razor, when lo and behold, he takes the harpoon from the bed corner,\n slips out the long wooden stock, unsheathes the head, whets it a little\n on his boot, and striding up to the bit of mirror against the wall,\n begins a vigorous scraping, or rather harpooning of his cheeks. Thinks\n I, Queequeg, this is using Rogers’s best cutlery with a vengeance.\n Afterwards I wondered the less at this operation when I came to know of\n what fine steel the head of a harpoon is made, and how exceedingly sharp\n the long straight edges are always kept.\n\n\n The rest of his toilet was soon achieved, and he proudly marched out of\n the room, wrapped up in his great pilot monkey jacket, and sporting his\n harpoon like a marshal’s baton.\n datetime: 2017-06-07T19:05:43.820Z\n date: 2017-06-07T19:05:36.240Z\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: b\n list:\n - object:\n date: 2017-06-07T19:10:25.684Z\n string: CHAPTER 4. The Counterpane.\n string: CHAPTER 3. The Spouter-Inn.\n---\n\n" + content: "---\ntitle: CHAPTER 1. Loomings.\nboolean: true\ntext: >-\n Call me Ishmael. Some years ago—never mind how long precisely—having little or\n no money in my purse, and nothing particular to interest me on shore, I\n thought I would sail about a little and see the watery part of the world. It\n is a way I have of driving off the spleen and regulating the circulation.\n Whenever I find myself growing grim about the mouth; whenever it is a damp,\n drizzly November in my soul; whenever I find myself involuntarily pausing\n before coffin warehouses, and bringing up the rear of every funeral I meet;\n and especially whenever my hypos get such an upper hand of me, that it\n requires a strong moral principle to prevent me from deliberately stepping\n into the street, and methodically knocking people’s hats off—then, I account\n it high time to get to sea as soon as I can. This is my substitute for pistol\n and ball. With a philosophical flourish Cato throws himself upon his sword; I\n quietly take to the ship. There is nothing surprising in this. If they but\n knew it, almost all men in their degree, some time or other, cherish very\n nearly the same feelings towards the ocean with me.\nnumber: '111111'\nmarkdown: \"# Call me Ishmael. Some years ago—never mind how long precisely—having little or no money in my purse, and nothing particular to interest me on shore, I thought I would sail about a little and see the watery part of the world. It is a way I have of driving off the spleen and regulating the circulation. Whenever I find myself growing grim about the mouth; whenever it is a damp, drizzly November in my soul; whenever I find myself involuntarily pausing before coffin warehouses, and bringing up the rear of every funeral I meet; and especially whenever my hypos get such an upper hand of me, that it requires a strong moral principle to prevent me from deliberately stepping into the street, and methodically knocking people’s hats off—then, I account it high time to get to sea as soon as I can. This is my substitute for pistol and ball. With a philosophical flourish Cato throws himself upon his sword; I quietly take to the ship. There is nothing surprising in this. If they but knew it, almost all men in their degree, some time or other, cherish very nearly the same feelings towards the ocean with me.\\n\\n## There now is your insular city of the Manhattoes, belted round by wharves as Indian isles by coral reefs—commerce surrounds it with her surf. Right and left, the streets take you waterward. Its extreme downtown is the battery, where that noble mole is washed by waves, and cooled by breezes, which a few hours previous were out of sight of land. Look at the crowds of water-gazers there.\\n\\n**Circumambulate the city of a dreamy Sabbath afternoon. Go from Corlears Hook to Coenties Slip, and from thence, by Whitehall, northward. What do you see?—Posted like silent sentinels all around the town, stand thousands upon thousands of mortal men fixed in ocean reveries. Some leaning against the spiles; some seated upon the pier-heads; some looking over the bulwarks of ships from China; some high aloft in the rigging, as if striving to get a still better seaward peep. But these are all landsmen; of week days pent up in lath and plaster—tied to counters, nailed to benches, clinched to desks. How then is this? Are the green fields gone? What do they here?**\\n\\n*But look! here come more crowds, pacing straight for the water, and seemingly bound for a dive. Strange! Nothing will content them but the extremest limit of the land; loitering under the shady lee of yonder warehouses will not suffice. No. They must get just as nigh the water as they possibly can without falling in. And there they stand—miles of them—leagues. Inlanders all, they come from lanes and alleys, streets and avenues—north, east, south, and west. Yet here they all unite. Tell me, does the magnetic virtue of the needles of the compasses of all those ships attract them thither?*\\n\\n[Once more. Say you are in the country; in some high land of lakes. Take almost any path you please, and ten to one it carries you down in a dale, and leaves you there by a pool in the stream. There is magic in it. Let the most absent-minded of men be plunged in his deepest reveries—stand that man on his legs, set his feet a-going, and he will infallibly lead you to water, if water there be in all that region. Should you ever be athirst in the great American desert, try this experiment, if your caravan happen to be supplied with a metaphysical professor. Yes, as every one knows, meditation and water are wedded for ever.](https://netlifycms.org)\\n\\n![moby dick](/moby-dick.jpg)\\n\\n{{< youtube lZ6NEHDgk58 >}}\\n\\nBut here is an artist. He desires to paint you the dreamiest, shadiest, quietest, most enchanting bit of romantic landscape in all the valley of the Saco. What is the chief element he employs? There stand his trees, each with a hollow trunk, as if a hermit and a crucifix were within; and here sleeps his meadow, and there sleep his cattle; and up from yonder cottage goes a sleepy smoke. Deep into distant woodlands winds a mazy way, reaching to overlapping spurs of mountains bathed in their hill-side blue. But though the picture lies thus tranced, and though this pine-tree shakes down its sighs like leaves upon this shepherd’s head, yet all were vain, unless the shepherd’s eye were fixed upon the magic stream before him. Go visit the Prairies in June, when for scores on scores of miles you wade knee-deep among Tiger-lilies—what is the one charm wanting?—Water—there is not a drop of water there! Were Niagara but a cataract of sand, would you travel your thousand miles to see it? Why did the poor poet of Tennessee, upon suddenly receiving two handfuls of silver, deliberate whether to buy him a coat, which he sadly needed, or invest his money in a pedestrian trip to Rockaway Beach? Why is almost every robust healthy boy with a robust healthy soul in him, at some time or other crazy to go to sea? Why upon your first voyage as a passenger, did you yourself feel such a mystical vibration, when first told that you and your ship were now out of sight of land? Why did the old Persians hold the sea holy? Why did the Greeks give it a separate deity, and own brother of Jove? Surely all this is not without meaning. And still deeper the meaning of that story of Narcissus, who because he could not grasp the tormenting, mild image he saw in the fountain, plunged into it and was drowned. But that same image, we ourselves see in all rivers and oceans. It is the image of the ungraspable phantom of life; and this is the key to it all.\\n\\nNow, when I say that I am in the habit of going to sea whenever I begin to grow hazy about the eyes, and begin to be over conscious of my lungs, I do not mean to have it inferred that I ever go to sea as a passenger. For to go as a passenger you must needs have a purse, and a purse is but a rag unless you have something in it. Besides, passengers get sea-sick—grow quarrelsome—don’t sleep of nights—do not enjoy themselves much, as a general thing;—no, I never go as a passenger; nor, though I am something of a salt, do I ever go to sea as a Commodore, or a Captain, or a Cook. I abandon the glory and distinction of such offices to those who like them. For my part, I abominate all honourable respectable toils, trials, and tribulations of every kind whatsoever. It is quite as much as I can do to take care of myself, without taking care of ships, barques, brigs, schooners, and what not. And as for going as cook,—though I confess there is considerable glory in that, a cook being a sort of officer on ship-board—yet, somehow, I never fancied broiling fowls;—though once broiled, judiciously buttered, and judgmatically salted and peppered, there is no one who will speak more respectfully, not to say reverentially, of a broiled fowl than I will. It is out of the idolatrous dotings of the old Egyptians upon broiled ibis and roasted river horse, that you see the mummies of those creatures in their huge bake-houses the pyramids.\\n\\nNo, when I go to sea, I go as a simple sailor, right before the mast, plumb down into the forecastle, aloft there to the royal mast-head. True, they rather order me about some, and make me jump from spar to spar, like a grasshopper in a May meadow. And at first, this sort of thing is unpleasant enough. It touches one’s sense of honour, particularly if you come of an old established family in the land, the Van Rensselaers, or Randolphs, or Hardicanutes. And more than all, if just previous to putting your hand into the tar-pot, you have been lording it as a country schoolmaster, making the tallest boys stand in awe of you. The transition is a keen one, I assure you, from a schoolmaster to a sailor, and requires a strong decoction of Seneca and the Stoics to enable you to grin and bear it. But even this wears off in time.\\n\\nWhat of it, if some old hunks of a sea-captain orders me to get a broom and sweep down the decks? What does that indignity amount to, weighed, I mean, in the scales of the New Testament? Do you think the archangel Gabriel thinks anything the less of me, because I promptly and respectfully obey that old hunks in that particular instance? Who ain’t a slave? Tell me that. Well, then, however the old sea-captains may order me about—however they may thump and punch me about, I have the satisfaction of knowing that it is all right; that everybody else is one way or other served in much the same way—either in a physical or metaphysical point of view, that is; and so the universal thump is passed round, and all hands should rub each other’s shoulder-blades, and be content.\\n\\nAgain, I always go to sea as a sailor, because they make a point of paying me for my trouble, whereas they never pay passengers a single penny that I ever heard of. On the contrary, passengers themselves must pay. And there is all the difference in the world between paying and being paid. The act of paying is perhaps the most uncomfortable infliction that the two orchard thieves entailed upon us. But\_*being paid*,—what will compare with it? The urbane activity with which a man receives money is really marvellous, considering that we so earnestly believe money to be the root of all earthly ills, and that on no account can a monied man enter heaven. Ah! how cheerfully we consign ourselves to perdition!\\n\\nFinally, I always go to sea as a sailor, because of the wholesome exercise and pure air of the fore-castle deck. For as in this world, head winds are far more prevalent than winds from astern (that is, if you never violate the Pythagorean maxim), so for the most part the Commodore on the quarter-deck gets his atmosphere at second hand from the sailors on the forecastle. He thinks he breathes it first; but not so. In much the same way do the commonalty lead their leaders in many other things, at the same time that the leaders little suspect it. But wherefore it was that after having repeatedly smelt the sea as a merchant sailor, I should now take it into my head to go on a whaling voyage; this the invisible police officer of the Fates, who has the constant surveillance of me, and secretly dogs me, and influences me in some unaccountable way—he can better answer than any one else. And, doubtless, my going on this whaling voyage, formed part of the grand programme of Providence that was drawn up a long time ago. It came in as a sort of brief interlude and solo between more extensive performances. I take it that this part of the bill must have run something like this:\\n\\n“*Grand Contested Election for the Presidency of the United States.*\_“WHALING VOYAGE BY ONE ISHMAEL. “BLOODY BATTLE IN AFFGHANISTAN.”\\n\\nThough I cannot tell why it was exactly that those stage managers, the Fates, put me down for this shabby part of a whaling voyage, when others were set down for magnificent parts in high tragedies, and short and easy parts in genteel comedies, and jolly parts in farces—though I cannot tell why this was exactly; yet, now that I recall all the circumstances, I think I can see a little into the springs and motives which being cunningly presented to me under various disguises, induced me to set about performing the part I did, besides cajoling me into the delusion that it was a choice resulting from my own unbiased freewill and discriminating judgment.\\n\\nChief among these motives was the overwhelming idea of the great whale himself. Such a portentous and mysterious monster roused all my curiosity. Then the wild and distant seas where he rolled his island bulk; the undeliverable, nameless perils of the whale; these, with all the attending marvels of a thousand Patagonian sights and sounds, helped to sway me to my wish. With other men, perhaps, such things would not have been inducements; but as for me, I am tormented with an everlasting itch for things remote. I love to sail forbidden seas, and land on barbarous coasts. Not ignoring what is good, I am quick to perceive a horror, and could still be social with it—would they let me—since it is but well to be on friendly terms with all the inmates of the place one lodges in.\\n\\nBy reason of these things, then, the whaling voyage was welcome; the great flood-gates of the wonder-world swung open, and in the wild conceits that swayed me to my purpose, two and two there floated into my inmost soul, endless processions of the whale, and, mid most of them all, one grand hooded phantom, like a snow hill in the air.\"\ndatetime: 2017-06-07T18:55:28.110Z\ndate: 2017-06-07T18:55:28.111Z\nimage: /moby-dick.jpg\nfile: /moby-dick.jpg\nselect: b\npost: 'This is a TOML front matter post'\nobject:\n boolean: true\n text: >-\n I stuffed a shirt or two into my old carpet-bag, tucked it under my arm, and\n started for Cape Horn and the Pacific. Quitting the good city of old\n Manhatto, I duly arrived in New Bedford. It was a Saturday night in\n December. Much was I disappointed upon learning that the little packet for\n Nantucket had already sailed, and that no way of reaching that place would\n offer, till the following Monday.\n number: '222222'\n markdown: >-\n # I stuffed a shirt or two into my old carpet-bag, tucked it under my arm,\n and started for Cape Horn and the Pacific. Quitting the good city of old\n Manhatto, I duly arrived in New Bedford. It was a Saturday night in\n December. Much was I disappointed upon learning that the little packet for\n Nantucket had already sailed, and that no way of reaching that place would\n offer, till the following Monday.\n\n\n ## As most young candidates for the pains and penalties of whaling stop at\n this same New Bedford, thence to embark on their voyage, it may as well be\n related that I, for one, had no idea of so doing. For my mind was made up to\n sail in no other than a Nantucket craft, because there was a fine,\n boisterous something about everything connected with that famous old island,\n which amazingly pleased me. Besides though New Bedford has of late been\n gradually monopolising the business of whaling, and though in this matter\n poor old Nantucket is now much behind her, yet Nantucket was her great\n original—the Tyre of this Carthage;—the place where the first dead American\n whale was stranded. Where else but from Nantucket did those aboriginal\n whalemen, the Red-Men, first sally out in canoes to give chase to the\n Leviathan? And where but from Nantucket, too, did that first adventurous\n little sloop put forth, partly laden with imported cobblestones—so goes the\n story—to throw at the whales, in order to discover when they were nigh\n enough to risk a harpoon from the bowsprit?\n\n\n **Now having a night, a day, and still another night following before me in\n New Bedford, ere I could embark for my destined port, it became a matter of\n concernment where I was to eat and sleep meanwhile. It was a very\n dubious-looking, nay, a very dark and dismal night, bitingly cold and\n cheerless. I knew no one in the place. With anxious grapnels I had sounded\n my pocket, and only brought up a few pieces of silver,—So, wherever you go,\n Ishmael, said I to myself, as I stood in the middle of a dreary street\n shouldering my bag, and comparing the gloom towards the north with the\n darkness towards the south—wherever in your wisdom you may conclude to lodge\n for the night, my dear Ishmael, be sure to inquire the price, and don’t be\n too particular.**\n\n\n *With halting steps I paced the streets, and passed the sign of “The Crossed\n Harpoons”—but it looked too expensive and jolly there. Further on, from the\n bright red windows of the “Sword-Fish Inn,” there came such fervent rays,\n that it seemed to have melted the packed snow and ice from before the house,\n for everywhere else the congealed frost lay ten inches thick in a hard,\n asphaltic pavement,—rather weary for me, when I struck my foot against the\n flinty projections, because from hard, remorseless service the soles of my\n boots were in a most miserable plight. Too expensive and jolly, again\n thought I, pausing one moment to watch the broad glare in the street, and\n hear the sounds of the tinkling glasses within. But go on, Ishmael, said I\n at last; don’t you hear? get away from before the door; your patched boots\n are stopping the way. So on I went. I now by instinct followed the streets\n that took me waterward, for there, doubtless, were the cheapest, if not the\n cheeriest inns.*\n\n\n [Such dreary streets! blocks of blackness, not houses, on either hand, and\n here and there a candle, like a candle moving about in a tomb. At this hour\n of the night, of the last day of the week, that quarter of the town proved\n all but deserted. But presently I came to a smoky light proceeding from a\n low, wide building, the door of which stood invitingly open. It had a\n careless look, as if it were meant for the uses of the public; so, entering,\n the first thing I did was to stumble over an ash-box in the porch. Ha!\n thought I, ha, as the flying particles almost choked me, are these ashes\n from that destroyed city, Gomorrah? But “The Crossed Harpoons,” and “The\n Sword-Fish?”—this, then must needs be the sign of “The Trap.” However, I\n picked myself up and hearing a loud voice within, pushed on and opened a\n second, interior door.](https://netlifycms.org)\n\n\n ![moby dick](/moby-dick.jpg)\n\n\n {{< youtube lZ6NEHDgk58 >}}\n\n\n It seemed the great Black Parliament sitting in Tophet. A hundred black\n faces turned round in their rows to peer; and beyond, a black Angel of Doom\n was beating a book in a pulpit. It was a negro church; and the preacher’s\n text was about the blackness of darkness, and the weeping and wailing and\n teeth-gnashing there. Ha, Ishmael, muttered I, backing out, Wretched\n entertainment at the sign of ‘The Trap!’\n\n\n Moving on, I at last came to a dim sort of light not far from the docks, and\n heard a forlorn creaking in the air; and looking up, saw a swinging sign\n over the door with a white painting upon it, faintly representing a tall\n straight jet of misty spray, and these words underneath—“The Spouter\n Inn:—Peter Coffin.”\n\n\n Coffin?—Spouter?—Rather ominous in that particular connexion, thought I. But\n it is a common name in Nantucket, they say, and I suppose this Peter here is\n an emigrant from there. As the light looked so dim, and the place, for the\n time, looked quiet enough, and the dilapidated little wooden house itself\n looked as if it might have been carted here from the ruins of some burnt\n district, and as the swinging sign had a poverty-stricken sort of creak to\n it, I thought that here was the very spot for cheap lodgings, and the best\n of pea coffee.\n\n\n It was a queer sort of place—a gable-ended old house, one side palsied as it\n were, and leaning over sadly. It stood on a sharp bleak corner, where that\n tempestuous wind Euroclydon kept up a worse howling than ever it did about\n poor Paul’s tossed craft. Euroclydon, nevertheless, is a mighty pleasant\n zephyr to any one in-doors, with his feet on the hob quietly toasting for\n bed. “In judging of that tempestuous wind called Euroclydon,” says an old\n writer—of whose works I possess the only copy extant—“it maketh a marvellous\n difference, whether thou lookest out at it from a glass window where the\n frost is all on the outside, or whether thou observest it from that sashless\n window, where the frost is on both sides, and of which the wight Death is\n the only glazier.” True enough, thought I, as this passage occurred to my\n mind—old black-letter, thou reasonest well. Yes, these eyes are windows, and\n this body of mine is the house. What a pity they didn’t stop up the chinks\n and the crannies though, and thrust in a little lint here and there. But\n it’s too late to make any improvements now. The universe is finished; the\n copestone is on, and the chips were carted off a million years ago. Poor\n Lazarus there, chattering his teeth against the curbstone for his pillow,\n and shaking off his tatters with his shiverings, he might plug up both ears\n with rags, and put a corn-cob into his mouth, and yet that would not keep\n out the tempestuous Euroclydon. Euroclydon! says old Dives, in his red\n silken wrapper—(he had a redder one afterwards) pooh, pooh! What a fine\n frosty night; how Orion glitters; what northern lights! Let them talk of\n their oriental summer climes of everlasting conservatories; give me the\n privilege of making my own summer with my own coals.\n\n\n But what thinks Lazarus? Can he warm his blue hands by holding them up to\n the grand northern lights? Would not Lazarus rather be in Sumatra than here?\n Would he not far rather lay him down lengthwise along the line of the\n equator; yea, ye gods! go down to the fiery pit itself, in order to keep out\n this frost?\n\n\n Now, that Lazarus should lie stranded there on the curbstone before the door\n of Dives, this is more wonderful than that an iceberg should be moored to\n one of the Moluccas. Yet Dives himself, he too lives like a Czar in an ice\n palace made of frozen sighs, and being a president of a temperance society,\n he only drinks the tepid tears of orphans.\n\n\n But no more of this blubbering now, we are going a-whaling, and there is\n plenty of that yet to come. Let us scrape the ice from our frosted feet, and\n see what sort of a place this “Spouter” may be.\n datetime: 2017-06-07T19:05:43.816Z\n date: 2017-06-07T18:55:28.115Z\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: b\n string: CHAPTER 2. The Carpet-Bag.\nlist:\n - text: >-\n Entering that gable-ended Spouter-Inn, you found yourself in a wide, low,\n straggling entry with old-fashioned wainscots, reminding one of the\n bulwarks of some condemned old craft. On one side hung a very large\n oilpainting so thoroughly besmoked, and every way defaced, that in the\n unequal crosslights by which you viewed it, it was only by diligent study\n and a series of systematic visits to it, and careful inquiry of the\n neighbors, that you could any way arrive at an understanding of its\n purpose. Such unaccountable masses of shades and shadows, that at first\n you almost thought some ambitious young artist, in the time of the New\n England hags, had endeavored to delineate chaos bewitched. But by dint of\n much and earnest contemplation, and oft repeated ponderings, and\n especially by throwing open the little window towards the back of the\n entry, you at last come to the conclusion that such an idea, however wild,\n might not be altogether unwarranted.\n number: '333333'\n markdown: \"# Entering that gable-ended Spouter-Inn, you found yourself in a wide, low, straggling entry with old-fashioned wainscots, reminding one of the bulwarks of some condemned old craft. On one side hung a very large oilpainting so thoroughly besmoked, and every way defaced, that in the unequal crosslights by which you viewed it, it was only by diligent study and a series of systematic visits to it, and careful inquiry of the neighbors, that you could any way arrive at an understanding of its purpose. Such unaccountable masses of shades and shadows, that at first you almost thought some ambitious young artist, in the time of the New England hags, had endeavored to delineate chaos bewitched. But by dint of much and earnest contemplation, and oft repeated ponderings, and especially by throwing open the little window towards the back of the entry, you at last come to the conclusion that such an idea, however wild, might not be altogether unwarranted.\n\n# But what most puzzled and confounded you was a long, limber, portentous, black mass of something hovering in the centre of the picture over three blue, dim, perpendicular lines floating in a nameless yeast. A boggy, soggy, squitchy picture truly, enough to drive a nervous man distracted. Yet was there a sort of indefinite, half-attained, unimaginable sublimity about it that fairly froze you to it, till you involuntarily took an oath with yourself to find out what that marvellous painting meant. Ever and anon a bright, but, alas, deceptive idea would dart you through.—It’s the Black Sea in a midnight gale.—It’s the unnatural combat of the four primal elements.—It’s a blasted heath.—It’s a Hyperborean winter scene.—It’s the breaking-up of the icebound stream of Time. But at last all these fancies yielded to that one portentous something in the picture’s midst.\_*That*\_once found out, and all the rest were plain. But stop; does it not bear a faint resemblance to a gigantic fish? even the great leviathan himself?\n\n## In fact, the artist’s design seemed this: a final theory of my own, partly based upon the aggregated opinions of many aged persons with whom I conversed upon the subject. The picture represents a Cape-Horner in a great hurricane; the half-foundered ship weltering there with its three dismantled masts alone visible; and an exasperated whale, purposing to spring clean over the craft, is in the enormous act of impaling himself upon the three mast-heads.\n\n## The opposite wall of this entry was hung all over with a heathenish array of monstrous clubs and spears. Some were thickly set with glittering teeth resembling ivory saws; others were tufted with knots of human hair; and one was sickle-shaped, with a vast handle sweeping round like the segment made in the new-mown grass by a long-armed mower. You shuddered as you gazed, and wondered what monstrous cannibal and savage could ever have gone a death-harvesting with such a hacking, horrifying implement. Mixed with these were rusty old whaling lances and harpoons all broken and deformed. Some were storied weapons. With this once long lance, now wildly elbowed, fifty years ago did Nathan Swain kill fifteen whales between a sunrise and a sunset. And that harpoon—so like a corkscrew now—was flung in Javan seas, and run away with by a whale, years afterwards slain off the Cape of Blanco. The original iron entered nigh the tail, and, like a restless needle sojourning in the body of a man, travelled full forty feet, and at last was found imbedded in the hump.\n\nCrossing this dusky entry, and on through yon low-arched way—cut through what in old times must have been a great central chimney with fireplaces all round—you enter the public room. A still duskier place is this, with such low ponderous beams above, and such old wrinkled planks beneath, that you would almost fancy you trod some old craft’s cockpits, especially of such a howling night, when this corner-anchored old ark rocked so furiously. On one side stood a long, low, shelf-like table covered with cracked glass cases, filled with dusty rarities gathered from this wide world’s remotest nooks. Projecting from the further angle of the room stands a dark-looking den—the bar—a rude attempt at a right whale’s head. Be that how it may, there stands the vast arched bone of the whale’s jaw, so wide, a coach might almost drive beneath it. Within are shabby shelves, ranged round with old decanters, bottles, flasks; and in those jaws of swift destruction, like another cursed Jonah (by which name indeed they called him), bustles a little withered old man, who, for their money, dearly sells the sailors deliriums and death.\n\nAbominable are the tumblers into which he pours his poison. Though true cylinders without—within, the villanous green goggling glasses deceitfully tapered downwards to a cheating bottom. Parallel meridians rudely pecked into the glass, surround these footpads’ goblets. Fill to\_*this*\_mark, and your charge is but a penny; to\_*this*\_a penny more; and so on to the full glass—the Cape Horn measure, which you may gulp down for a shilling.\n\nUpon entering the place I found a number of young seamen gathered about a table, examining by a dim light divers specimens of\_*skrimshander*. I sought the landlord, and telling him I desired to be accommodated with a room, received for answer that his house was full—not a bed unoccupied. “But avast,” he added, tapping his forehead, “you haint no objections to sharing a harpooneer’s blanket, have ye? I s’pose you are goin’ a-whalin’, so you’d better get used to that sort of thing.”\n\nI told him that I never liked to sleep two in a bed; that if I should ever do so, it would depend upon who the harpooneer might be, and that if he (the landlord) really had no other place for me, and the harpooneer was not decidedly objectionable, why rather than wander further about a strange town on so bitter a night, I would put up with the half of any decent man’s blanket.\n\n“I thought so. All right; take a seat. Supper?—you want supper? Supper’ll be ready directly.”\n\nI sat down on an old wooden settle, carved all over like a bench on the Battery. At one end a ruminating tar was still further adorning it with his jack-knife, stooping over and diligently working away at the space between his legs. He was trying his hand at a ship under full sail, but he didn’t make much headway, I thought.\n\nAt last some four or five of us were summoned to our meal in an adjoining room. It was cold as Iceland—no fire at all—the landlord said he couldn’t afford it. Nothing but two dismal tallow candles, each in a winding sheet. We were fain to button up our monkey jackets, and hold to our lips cups of scalding tea with our half frozen fingers. But the fare was of the most substantial kind—not only meat and potatoes, but dumplings; good heavens! dumplings for supper! One young fellow in a green box coat, addressed himself to these dumplings in a most direful manner.\n\n“My boy,” said the landlord, “you’ll have the nightmare to a dead sartainty.”\n\n“Landlord,” I whispered, “that aint the harpooneer is it?”\n\n“Oh, no,” said he, looking a sort of diabolically funny, “the harpooneer is a dark complexioned chap. He never eats dumplings, he don’t—he eats nothing but steaks, and he likes ‘em rare.”\n\n“The devil he does,” says I. “Where is that harpooneer? Is he here?”\n\n“He’ll be here afore long,” was the answer.\n\nI could not help it, but I began to feel suspicious of this “dark complexioned” harpooneer. At any rate, I made up my mind that if it so turned out that we should sleep together, he must undress and get into bed before I did.\n\nSupper over, the company went back to the bar-room, when, knowing not what else to do with myself, I resolved to spend the rest of the evening as a looker on.\n\nPresently a rioting noise was heard without. Starting up, the landlord cried, “That’s the Grampus’s crew. I seed her reported in the offing this morning; a three years’ voyage, and a full ship. Hurrah, boys; now we’ll have the latest news from the Feegees.”\n\nA tramping of sea boots was heard in the entry; the door was flung open, and in rolled a wild set of mariners enough. Enveloped in their shaggy watch coats, and with their heads muffled in woollen comforters, all bedarned and ragged, and their beards stiff with icicles, they seemed an eruption of bears from Labrador. They had just landed from their boat, and this was the first house they entered. No wonder, then, that they made a straight wake for the whale’s mouth—the bar—when the wrinkled little old Jonah, there officiating, soon poured them out brimmers all round. One complained of a bad cold in his head, upon which Jonah mixed him a pitch-like potion of gin and molasses, which he swore was a sovereign cure for all colds and catarrhs whatsoever, never mind of how long standing, or whether caught off the coast of Labrador, or on the weather side of an ice-island.\n\nThe liquor soon mounted into their heads, as it generally does even with the arrantest topers newly landed from sea, and they began capering about most obstreperously.\n\nI observed, however, that one of them held somewhat aloof, and though he seemed desirous not to spoil the hilarity of his shipmates by his own sober face, yet upon the whole he refrained from making as much noise as the rest. This man interested me at once; and since the sea-gods had ordained that he should soon become my shipmate (though but a sleeping-partner one, so far as this narrative is concerned), I will here venture upon a little description of him. He stood full six feet in height, with noble shoulders, and a chest like a coffer-dam. I have seldom seen such brawn in a man. His face was deeply brown and burnt, making his white teeth dazzling by the contrast; while in the deep shadows of his eyes floated some reminiscences that did not seem to give him much joy. His voice at once announced that he was a Southerner, and from his fine stature, I thought he must be one of those tall mountaineers from the Alleghanian Ridge in Virginia. When the revelry of his companions had mounted to its height, this man slipped away unobserved, and I saw no more of him till he became my comrade on the sea. In a few minutes, however, he was missed by his shipmates, and being, it seems, for some reason a huge favourite with them, they raised a cry of “Bulkington! Bulkington! where’s Bulkington?” and darted out of the house in pursuit of him.\n\nIt was now about nine o’clock, and the room seeming almost supernaturally quiet after these orgies, I began to congratulate myself upon a little plan that had occurred to me just previous to the entrance of the seamen.\n\nNo man prefers to sleep two in a bed. In fact, you would a good deal rather not sleep with your own brother. I don’t know how it is, but people like to be private when they are sleeping. And when it comes to sleeping with an unknown stranger, in a strange inn, in a strange town, and that stranger a harpooneer, then your objections indefinitely multiply. Nor was there any earthly reason why I as a sailor should sleep two in a bed, more than anybody else; for sailors no more sleep two in a bed at sea, than bachelor Kings do ashore. To be sure they all sleep together in one apartment, but you have your own hammock, and cover yourself with your own blanket, and sleep in your own skin.\n\nThe more I pondered over this harpooneer, the more I abominated the thought of sleeping with him. It was fair to presume that being a harpooneer, his linen or woollen, as the case might be, would not be of the tidiest, certainly none of the finest. I began to twitch all over. Besides, it was getting late, and my decent harpooneer ought to be home and going bedwards. Suppose now, he should tumble in upon me at midnight—how could I tell from what vile hole he had been coming?\n\n“Landlord! I’ve changed my mind about that harpooneer.—I shan’t sleep with him. I’ll try the bench here.”\n\n“Just as you please; I’m sorry I can’t spare ye a tablecloth for a mattress, and it’s a plaguy rough board here”—feeling of the knots and notches. “But wait a bit, Skrimshander; I’ve got a carpenter’s plane there in the bar—wait, I say, and I’ll make ye snug enough.” So saying he procured the plane; and with his old silk handkerchief first dusting the bench, vigorously set to planing away at my bed, the while grinning like an ape. The shavings flew right and left; till at last the plane-iron came bump against an indestructible knot. The landlord was near spraining his wrist, and I told him for heaven’s sake to quit—the bed was soft enough to suit me, and I did not know how all the planing in the world could make eider down of a pine plank. So gathering up the shavings with another grin, and throwing them into the great stove in the middle of the room, he went about his business, and left me in a brown study.\n\nI now took the measure of the bench, and found that it was a foot too short; but that could be mended with a chair. But it was a foot too narrow, and the other bench in the room was about four inches higher than the planned one—so there was no yoking them. I then placed the first bench lengthwise along the only clear space against the wall, leaving a little interval between, for my back to settle down in. But I soon found that there came such a draught of cold air over me from under the sill of the window, that this plan would never do at all, especially as another current from the rickety door met the one from the window, and both together formed a series of small whirlwinds in the immediate vicinity of the spot where I had thought to spend the night.\n\nThe devil fetch that harpooneer, thought I, but stop, couldn’t I steal a march on him—bolt his door inside, and jump into his bed, not to be wakened by the most violent knockings? It seemed no bad idea; but upon second thoughts I dismissed it. For who could tell but what the next morning, so soon as I popped out of the room, the harpooneer might be standing in the entry, all ready to knock me down!\n\nStill, looking round me again, and seeing no possible chance of spending a sufferable night unless in some other person’s bed, I began to think that after all I might be cherishing unwarrantable prejudices against this unknown harpooneer. Thinks I, I’ll wait awhile; he must be dropping in before long. I’ll have a good look at him then, and perhaps we may become jolly good bedfellows after all—there’s no telling.\n\nBut though the other boarders kept coming in by ones, twos, and threes, and going to bed, yet no sign of my harpooneer.\n\n“Landlord!” said I, “what sort of a chap is he—does he always keep such late hours?” It was now hard upon twelve o’clock.\n\nThe landlord chuckled again with his lean chuckle, and seemed to be mightily tickled at something beyond my comprehension. “No,” he answered, “generally he’s an early bird—airley to bed and airley to rise—yes, he’s the bird what catches the worm. But to-night he went out a peddling, you see, and I don’t see what on airth keeps him so late, unless, may be, he can’t sell his head.”\n\n“Can’t sell his head?—What sort of a bamboozingly story is this you are telling me?” getting into a towering rage. “Do you pretend to say, landlord, that this harpooneer is actually engaged this blessed Saturday night, or rather Sunday morning, in peddling his head around this town?”\n\n“That’s precisely it,” said the landlord, “and I told him he couldn’t sell it here, the market’s overstocked.”\n\n“With what?” shouted I.\n\n“With heads to be sure; ain’t there too many heads in the world?”\n\n“I tell you what it is, landlord,” said I quite calmly, “you’d better stop spinning that yarn to me—I’m not green.”\n\n“May be not,” taking out a stick and whittling a toothpick, “but I rayther guess you’ll be done\_*brown*\_if that ere harpooneer hears you a slanderin’ his head.”\n\n“I’ll break it for him,” said I, now flying into a passion again at this unaccountable farrago of the landlord’s.\n\n“It’s broke a’ready,” said he.\n\n“Broke,” said I—“*broke*, do you mean?”\n\n“Sartain, and that’s the very reason he can’t sell it, I guess.”\n\n“Landlord,” said I, going up to him as cool as Mt. Hecla in a snow-storm—“landlord, stop whittling. You and I must understand one another, and that too without delay. I come to your house and want a bed; you tell me you can only give me half a one; that the other half belongs to a certain harpooneer. And about this harpooneer, whom I have not yet seen, you persist in telling me the most mystifying and exasperating stories tending to beget in me an uncomfortable feeling towards the man whom you design for my bedfellow—a sort of connexion, landlord, which is an intimate and confidential one in the highest degree. I now demand of you to speak out and tell me who and what this harpooneer is, and whether I shall be in all respects safe to spend the night with him. And in the first place, you will be so good as to unsay that story about selling his head, which if true I take to be good evidence that this harpooneer is stark mad, and I’ve no idea of sleeping with a madman; and you, sir,\_*you*\_I mean, landlord,\_*you*, sir, by trying to induce me to do so knowingly, would thereby render yourself liable to a criminal prosecution.”\n\n“Wall,” said the landlord, fetching a long breath, “that’s a purty long sarmon for a chap that rips a little now and then. But be easy, be easy, this here harpooneer I have been tellin’ you of has just arrived from the south seas, where he bought up a lot of ‘balmed New Zealand heads (great curios, you know), and he’s sold all on ‘em but one, and that one he’s trying to sell to-night, cause to-morrow’s Sunday, and it would not do to be sellin’ human heads about the streets when folks is goin’ to churches. He wanted to, last Sunday, but I stopped him just as he was goin’ out of the door with four heads strung on a string, for all the airth like a string of inions.”\n\nThis account cleared up the otherwise unaccountable mystery, and showed that the landlord, after all, had had no idea of fooling me—but at the same time what could I think of a harpooneer who stayed out of a Saturday night clean into the holy Sabbath, engaged in such a cannibal business as selling the heads of dead idolators?\n\n“Depend upon it, landlord, that harpooneer is a dangerous man.”\n\n“He pays reg’lar,” was the rejoinder. “But come, it’s getting dreadful late, you had better be turning flukes—it’s a nice bed; Sal and me slept in that ere bed the night we were spliced. There’s plenty of room for two to kick about in that bed; it’s an almighty big bed that. Why, afore we give it up, Sal used to put our Sam and little Johnny in the foot of it. But I got a dreaming and sprawling about one night, and somehow, Sam got pitched on the floor, and came near breaking his arm. Arter that, Sal said it wouldn’t do. Come along here, I’ll give ye a glim in a jiffy;” and so saying he lighted a candle and held it towards me, offering to lead the way. But I stood irresolute; when looking at a clock in the corner, he exclaimed “I vum it’s Sunday—you won’t see that harpooneer to-night; he’s come to anchor somewhere—come along then;\_*do*\_come;\_*won’t*\_ye come?”\n\nI considered the matter a moment, and then up stairs we went, and I was ushered into a small room, cold as a clam, and furnished, sure enough, with a prodigious bed, almost big enough indeed for any four harpooneers to sleep abreast.\n\n“There,” said the landlord, placing the candle on a crazy old sea chest that did double duty as a wash-stand and centre table; “there, make yourself comfortable now, and good night to ye.” I turned round from eyeing the bed, but he had disappeared.\n\nFolding back the counterpane, I stooped over the bed. Though none of the most elegant, it yet stood the scrutiny tolerably well. I then glanced round the room; and besides the bedstead and centre table, could see no other furniture belonging to the place, but a rude shelf, the four walls, and a papered fireboard representing a man striking a whale. Of things not properly belonging to the room, there was a hammock lashed up, and thrown upon the floor in one corner; also a large seaman’s bag, containing the harpooneer’s wardrobe, no doubt in lieu of a land trunk. Likewise, there was a parcel of outlandish bone fish hooks on the shelf over the fire-place, and a tall harpoon standing at the head of the bed.\n\nBut what is this on the chest? I took it up, and held it close to the light, and felt it, and smelt it, and tried every way possible to arrive at some satisfactory conclusion concerning it. I can compare it to nothing but a large door mat, ornamented at the edges with little tinkling tags something like the stained porcupine quills round an Indian moccasin. There was a hole or slit in the middle of this mat, as you see the same in South American ponchos. But could it be possible that any sober harpooneer would get into a door mat, and parade the streets of any Christian town in that sort of guise? I put it on, to try it, and it weighed me down like a hamper, being uncommonly shaggy and thick, and I thought a little damp, as though this mysterious harpooneer had been wearing it of a rainy day. I went up in it to a bit of glass stuck against the wall, and I never saw such a sight in my life. I tore myself out of it in such a hurry that I gave myself a kink in the neck.\n\nI sat down on the side of the bed, and commenced thinking about this head-peddling harpooneer, and his door mat. After thinking some time on the bed-side, I got up and took off my monkey jacket, and then stood in the middle of the room thinking. I then took off my coat, and thought a little more in my shirt sleeves. But beginning to feel very cold now, half undressed as I was, and remembering what the landlord said about the harpooneer’s not coming home at all that night, it being so very late, I made no more ado, but jumped out of my pantaloons and boots, and then blowing out the light tumbled into bed, and commended myself to the care of heaven.\n\nWhether that mattress was stuffed with corn-cobs or broken crockery, there is no telling, but I rolled about a good deal, and could not sleep for a long time. At last I slid off into a light doze, and had pretty nearly made a good offing towards the land of Nod, when I heard a heavy footfall in the passage, and saw a glimmer of light come into the room from under the door.\n\nLord save me, thinks I, that must be the harpooneer, the infernal head-peddler. But I lay perfectly still, and resolved not to say a word till spoken to. Holding a light in one hand, and that identical New Zealand head in the other, the stranger entered the room, and without looking towards the bed, placed his candle a good way off from me on the floor in one corner, and then began working away at the knotted cords of the large bag I before spoke of as being in the room. I was all eagerness to see his face, but he kept it averted for some time while employed in unlacing the bag’s mouth. This accomplished, however, he turned round—when, good heavens! what a sight! Such a face! It was of a dark, purplish, yellow colour, here and there stuck over with large blackish looking squares. Yes, it’s just as I thought, he’s a terrible bedfellow; he’s been in a fight, got dreadfully cut, and here he is, just from the surgeon. But at that moment he chanced to turn his face so towards the light, that I plainly saw they could not be sticking-plasters at all, those black squares on his cheeks. They were stains of some sort or other. At first I knew not what to make of this; but soon an inkling of the truth occurred to me. I remembered a story of a white man—a whaleman too—who, falling among the cannibals, had been tattooed by them. I concluded that this harpooneer, in the course of his distant voyages, must have met with a similar adventure. And what is it, thought I, after all! It’s only his outside; a man can be honest in any sort of skin. But then, what to make of his unearthly complexion, that part of it, I mean, lying round about, and completely independent of the squares of tattooing. To be sure, it might be nothing but a good coat of tropical tanning; but I never heard of a hot sun’s tanning a white man into a purplish yellow one. However, I had never been in the South Seas; and perhaps the sun there produced these extraordinary effects upon the skin. Now, while all these ideas were passing through me like lightning, this harpooneer never noticed me at all. But, after some difficulty having opened his bag, he commenced fumbling in it, and presently pulled out a sort of tomahawk, and a seal-skin wallet with the hair on. Placing these on the old chest in the middle of the room, he then took the New Zealand head—a ghastly thing enough—and crammed it down into the bag. He now took off his hat—a new beaver hat—when I came nigh singing out with fresh surprise. There was no hair on his head—none to speak of at least—nothing but a small scalp-knot twisted up on his forehead. His bald purplish head now looked for all the world like a mildewed skull. Had not the stranger stood between me and the door, I would have bolted out of it quicker than ever I bolted a dinner.\n\nEven as it was, I thought something of slipping out of the window, but it was the second floor back. I am no coward, but what to make of this head-peddling purple rascal altogether passed my comprehension. Ignorance is the parent of fear, and being completely nonplussed and confounded about the stranger, I confess I was now as much afraid of him as if it was the devil himself who had thus broken into my room at the dead of night. In fact, I was so afraid of him that I was not game enough just then to address him, and demand a satisfactory answer concerning what seemed inexplicable in him.\n\nMeanwhile, he continued the business of undressing, and at last showed his chest and arms. As I live, these covered parts of him were checkered with the same squares as his face; his back, too, was all over the same dark squares; he seemed to have been in a Thirty Years’ War, and just escaped from it with a sticking-plaster shirt. Still more, his very legs were marked, as if a parcel of dark green frogs were running up the trunks of young palms. It was now quite plain that he must be some abominable savage or other shipped aboard of a whaleman in the South Seas, and so landed in this Christian country. I quaked to think of it. A peddler of heads too—perhaps the heads of his own brothers. He might take a fancy to mine—heavens! look at that tomahawk!\n\nBut there was no time for shuddering, for now the savage went about something that completely fascinated my attention, and convinced me that he must indeed be a heathen. Going to his heavy grego, or wrapall, or dreadnaught, which he had previously hung on a chair, he fumbled in the pockets, and produced at length a curious little deformed image with a hunch on its back, and exactly the colour of a three days’ old Congo baby. Remembering the embalmed head, at first I almost thought that this black manikin was a real baby preserved in some similar manner. But seeing that it was not at all limber, and that it glistened a good deal like polished ebony, I concluded that it must be nothing but a wooden idol, which indeed it proved to be. For now the savage goes up to the empty fire-place, and removing the papered fire-board, sets up this little hunch-backed image, like a tenpin, between the andirons. The chimney jambs and all the bricks inside were very sooty, so that I thought this fire-place made a very appropriate little shrine or chapel for his Congo idol.\n\nI now screwed my eyes hard towards the half hidden image, feeling but ill at ease meantime—to see what was next to follow. First he takes about a double handful of shavings out of his grego pocket, and places them carefully before the idol; then laying a bit of ship biscuit on top and applying the flame from the lamp, he kindled the shavings into a sacrificial blaze. Presently, after many hasty snatches into the fire, and still hastier withdrawals of his fingers (whereby he seemed to be scorching them badly), he at last succeeded in drawing out the biscuit; then blowing off the heat and ashes a little, he made a polite offer of it to the little negro. But the little devil did not seem to fancy such dry sort of fare at all; he never moved his lips. All these strange antics were accompanied by still stranger guttural noises from the devotee, who seemed to be praying in a sing-song or else singing some pagan psalmody or other, during which his face twitched about in the most unnatural manner. At last extinguishing the fire, he took the idol up very unceremoniously, and bagged it again in his grego pocket as carelessly as if he were a sportsman bagging a dead woodcock.\n\nAll these queer proceedings increased my uncomfortableness, and seeing him now exhibiting strong symptoms of concluding his business operations, and jumping into bed with me, I thought it was high time, now or never, before the light was put out, to break the spell in which I had so long been bound.\n\nBut the interval I spent in deliberating what to say, was a fatal one. Taking up his tomahawk from the table, he examined the head of it for an instant, and then holding it to the light, with his mouth at the handle, he puffed out great clouds of tobacco smoke. The next moment the light was extinguished, and this wild cannibal, tomahawk between his teeth, sprang into bed with me. I sang out, I could not help it now; and giving a sudden grunt of astonishment he began feeling me.\n\nStammering out something, I knew not what, I rolled away from him against the wall, and then conjured him, whoever or whatever he might be, to keep quiet, and let me get up and light the lamp again. But his guttural responses satisfied me at once that he but ill comprehended my meaning.\n\n“Who-e debel you?”—he at last said—“you no speak-e, dam-me, I kill-e.” And so saying the lighted tomahawk began flourishing about me in the dark.\n\n“Landlord, for God’s sake, Peter Coffin!” shouted I. “Landlord! Watch! Coffin! Angels! save me!”\n\n“Speak-e! tell-ee me who-ee be, or dam-me, I kill-e!” again growled the cannibal, while his horrid flourishings of the tomahawk scattered the hot tobacco ashes about me till I thought my linen would get on fire. But thank heaven, at that moment the landlord came into the room light in hand, and leaping from the bed I ran up to him.\n\n“Don’t be afraid now,” said he, grinning again, “Queequeg here wouldn’t harm a hair of your head.”\n\n“Stop your grinning,” shouted I, “and why didn’t you tell me that that infernal harpooneer was a cannibal?”\n\n“I thought ye know’d it;—didn’t I tell ye, he was a peddlin’ heads around town?—but turn flukes again and go to sleep. Queequeg, look here—you sabbee me, I sabbee—you this man sleepe you—you sabbee?”\n\n“Me sabbee plenty”—grunted Queequeg, puffing away at his pipe and sitting up in bed.\n\n“You gettee in,” he added, motioning to me with his tomahawk, and throwing the clothes to one side. He really did this in not only a civil but a really kind and charitable way. I stood looking at him a moment. For all his tattooings he was on the whole a clean, comely looking cannibal. What’s all this fuss I have been making about, thought I to myself—the man’s a human being just as I am: he has just as much reason to fear me, as I have to be afraid of him. Better sleep with a sober cannibal than a drunken Christian.\n\n“Landlord,” said I, “tell him to stash his tomahawk there, or pipe, or whatever you call it; tell him to stop smoking, in short, and I will turn in with him. But I don’t fancy having a man smoking in bed with me. It’s dangerous. Besides, I ain’t insured.”\n\nThis being told to Queequeg, he at once complied, and again politely motioned me to get into bed—rolling over to one side as much as to say—“I won’t touch a leg of ye.”\n\n“Good night, landlord,” said I, “you may go.”\n\nI turned in, and never slept better in my life.\"\n datetime: 2017-06-02T00:00:00-04:00\n date: 2017-06-07T00:00:00-04:00\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: c\n object:\n text: >-\n Upon waking next morning about daylight, I found Queequeg’s arm thrown\n over me in the most loving and affectionate manner. You had almost\n thought I had been his wife. The counterpane was of patchwork, full of\n odd little parti-coloured squares and triangles; and this arm of his\n tattooed all over with an interminable Cretan labyrinth of a figure, no\n two parts of which were of one precise shade—owing I suppose to his\n keeping his arm at sea unmethodically in sun and shade, his shirt\n sleeves irregularly rolled up at various times—this same arm of his, I\n say, looked for all the world like a strip of that same patchwork quilt.\n Indeed, partly lying on it as the arm did when I first awoke, I could\n hardly tell it from the quilt, they so blended their hues together; and\n it was only by the sense of weight and pressure that I could tell that\n Queequeg was hugging me.\n number: '444444'\n markdown: >-\n # Upon waking next morning about daylight, I found Queequeg’s arm thrown\n over me in the most loving and affectionate manner. You had almost\n thought I had been his wife. The counterpane was of patchwork, full of\n odd little parti-coloured squares and triangles; and this arm of his\n tattooed all over with an interminable Cretan labyrinth of a figure, no\n two parts of which were of one precise shade—owing I suppose to his\n keeping his arm at sea unmethodically in sun and shade, his shirt\n sleeves irregularly rolled up at various times—this same arm of his, I\n say, looked for all the world like a strip of that same patchwork quilt.\n Indeed, partly lying on it as the arm did when I first awoke, I could\n hardly tell it from the quilt, they so blended their hues together; and\n it was only by the sense of weight and pressure that I could tell that\n Queequeg was hugging me.\n\n\n ## My sensations were strange. Let me try to explain them. When I was a\n child, I well remember a somewhat similar circumstance that befell me;\n whether it was a reality or a dream, I never could entirely settle. The\n circumstance was this. I had been cutting up some caper or other—I think\n it was trying to crawl up the chimney, as I had seen a little sweep do a\n few days previous; and my stepmother who, somehow or other, was all the\n time whipping me, or sending me to bed supperless,—my mother dragged me\n by the legs out of the chimney and packed me off to bed, though it was\n only two o’clock in the afternoon of the 21st June, the longest day in\n the year in our hemisphere. I felt dreadfully. But there was no help for\n it, so up stairs I went to my little room in the third floor, undressed\n myself as slowly as possible so as to kill time, and with a bitter sigh\n got between the sheets.\n\n\n I lay there dismally calculating that sixteen entire hours must elapse\n before I could hope for a resurrection. Sixteen hours in bed! the small\n of my back ached to think of it. And it was so light too; the sun\n shining in at the window, and a great rattling of coaches in the\n streets, and the sound of gay voices all over the house. I felt worse\n and worse—at last I got up, dressed, and softly going down in my\n stockinged feet, sought out my stepmother, and suddenly threw myself at\n her feet, beseeching her as a particular favour to give me a good\n slippering for my misbehaviour; anything indeed but condemning me to lie\n abed such an unendurable length of time. But she was the best and most\n conscientious of stepmothers, and back I had to go to my room. For\n several hours I lay there broad awake, feeling a great deal worse than I\n have ever done since, even from the greatest subsequent misfortunes. At\n last I must have fallen into a troubled nightmare of a doze; and slowly\n waking from it—half steeped in dreams—I opened my eyes, and the before\n sun-lit room was now wrapped in outer darkness. Instantly I felt a shock\n running through all my frame; nothing was to be seen, and nothing was to\n be heard; but a supernatural hand seemed placed in mine. My arm hung\n over the counterpane, and the nameless, unimaginable, silent form or\n phantom, to which the hand belonged, seemed closely seated by my\n bed-side. For what seemed ages piled on ages, I lay there, frozen with\n the most awful fears, not daring to drag away my hand; yet ever thinking\n that if I could but stir it one single inch, the horrid spell would be\n broken. I knew not how this consciousness at last glided away from me;\n but waking in the morning, I shudderingly remembered it all, and for\n days and weeks and months afterwards I lost myself in confounding\n attempts to explain the mystery. Nay, to this very hour, I often puzzle\n myself with it.\n\n\n Now, take away the awful fear, and my sensations at feeling the\n supernatural hand in mine were very similar, in their strangeness, to\n those which I experienced on waking up and seeing Queequeg’s pagan arm\n thrown round me. But at length all the past night’s events soberly\n recurred, one by one, in fixed reality, and then I lay only alive to the\n comical predicament. For though I tried to move his arm—unlock his\n bridegroom clasp—yet, sleeping as he was, he still hugged me tightly, as\n though naught but death should part us twain. I now strove to rouse\n him—“Queequeg!”—but his only answer was a snore. I then rolled over, my\n neck feeling as if it were in a horse-collar; and suddenly felt a slight\n scratch. Throwing aside the counterpane, there lay the tomahawk sleeping\n by the savage’s side, as if it were a hatchet-faced baby. A pretty\n pickle, truly, thought I; abed here in a strange house in the broad day,\n with a cannibal and a tomahawk! “Queequeg!—in the name of goodness,\n Queequeg, wake!” At length, by dint of much wriggling, and loud and\n incessant expostulations upon the unbecomingness of his hugging a fellow\n male in that matrimonial sort of style, I succeeded in extracting a\n grunt; and presently, he drew back his arm, shook himself all over like\n a Newfoundland dog just from the water, and sat up in bed, stiff as a\n pike-staff, looking at me, and rubbing his eyes as if he did not\n altogether remember how I came to be there, though a dim consciousness\n of knowing something about me seemed slowly dawning over him. Meanwhile,\n I lay quietly eyeing him, having no serious misgivings now, and bent\n upon narrowly observing so curious a creature. When, at last, his mind\n seemed made up touching the character of his bedfellow, and he became,\n as it were, reconciled to the fact; he jumped out upon the floor, and by\n certain signs and sounds gave me to understand that, if it pleased me,\n he would dress first and then leave me to dress afterwards, leaving the\n whole apartment to myself. Thinks I, Queequeg, under the circumstances,\n this is a very civilized overture; but, the truth is, these savages have\n an innate sense of delicacy, say what you will; it is marvellous how\n essentially polite they are. I pay this particular compliment to\n Queequeg, because he treated me with so much civility and consideration,\n while I was guilty of great rudeness; staring at him from the bed, and\n watching all his toilette motions; for the time my curiosity getting the\n better of my breeding. Nevertheless, a man like Queequeg you don’t see\n every day, he and his ways were well worth unusual regarding.\n\n\n He commenced dressing at top by donning his beaver hat, a very tall one,\n by the by, and then—still minus his trowsers—he hunted up his boots.\n What under the heavens he did it for, I cannot tell, but his next\n movement was to crush himself—boots in hand, and hat on—under the bed;\n when, from sundry violent gaspings and strainings, I inferred he was\n hard at work booting himself; though by no law of propriety that I ever\n heard of, is any man required to be private when putting on his boots.\n But Queequeg, do you see, was a creature in the transition stage—neither\n caterpillar nor butterfly. He was just enough civilized to show off his\n outlandishness in the strangest possible manners. His education was not\n yet completed. He was an undergraduate. If he had not been a small\n degree civilized, he very probably would not have troubled himself with\n boots at all; but then, if he had not been still a savage, he never\n would have dreamt of getting under the bed to put them on. At last, he\n emerged with his hat very much dented and crushed down over his eyes,\n and began creaking and limping about the room, as if, not being much\n accustomed to boots, his pair of damp, wrinkled cowhide ones—probably\n not made to order either—rather pinched and tormented him at the first\n go off of a bitter cold morning.\n\n\n Seeing, now, that there were no curtains to the window, and that the\n street being very narrow, the house opposite commanded a plain view into\n the room, and observing more and more the indecorous figure that\n Queequeg made, staving about with little else but his hat and boots on;\n I begged him as well as I could, to accelerate his toilet somewhat, and\n particularly to get into his pantaloons as soon as possible. He\n complied, and then proceeded to wash himself. At that time in the\n morning any Christian would have washed his face; but Queequeg, to my\n amazement, contented himself with restricting his ablutions to his\n chest, arms, and hands. He then donned his waistcoat, and taking up a\n piece of hard soap on the wash-stand centre table, dipped it into water\n and commenced lathering his face. I was watching to see where he kept\n his razor, when lo and behold, he takes the harpoon from the bed corner,\n slips out the long wooden stock, unsheathes the head, whets it a little\n on his boot, and striding up to the bit of mirror against the wall,\n begins a vigorous scraping, or rather harpooning of his cheeks. Thinks\n I, Queequeg, this is using Rogers’s best cutlery with a vengeance.\n Afterwards I wondered the less at this operation when I came to know of\n what fine steel the head of a harpoon is made, and how exceedingly sharp\n the long straight edges are always kept.\n\n\n The rest of his toilet was soon achieved, and he proudly marched out of\n the room, wrapped up in his great pilot monkey jacket, and sporting his\n harpoon like a marshal’s baton.\n datetime: 2017-06-07T19:05:43.820Z\n date: 2017-06-07T19:05:36.240Z\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n select: b\n list:\n - object:\n date: 2017-06-07T19:10:25.684Z\n string: CHAPTER 4. The Counterpane.\n string: CHAPTER 3. The Spouter-Inn.\ntyped_list:\n - type: type_1_object\n string: CHAPTER 2. The Carpet-Bag.\n boolean: true\n text: >-\n I stuffed a shirt or two into my old carpet-bag, tucked it under my arm, and\n started for Cape Horn and the Pacific. Quitting the good city of old\n Manhatto, I duly arrived in New Bedford. It was a Saturday night in\n December. Much was I disappointed upon learning that the little packet for\n Nantucket had already sailed, and that no way of reaching that place would\n offer, till the following Monday.\n - type: type_2_object\n number: 3\n select: b\n datetime: 2017-06-07T19:05:43.816Z\n markdown: >-\n Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam eget\n facilisis magna. Integer eget eleifend quam, sit amet sodales nisi. Fusce\n non lacus tempus, posuere tellus semper, facilisis lectus. Cras consequat\n aliquet ex.\n - type: type_1_object\n string: CHAPTER 2. The Carpet-Bag.\n boolean: false\n text: >-\n Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec elementum\n augue ornare lectus finibus mollis. Maecenas fringilla lorem at nisl pharetra\n scelerisque.\n - type: type_3_object\n date: 2017-06-07T18:55:28.111Z\n image: /moby-dick.jpg\n file: /moby-dick.jpg\n---\n\n" } } } diff --git a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js index 71958e3a3e3a..ca98c262d1ca 100644 --- a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js +++ b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js @@ -4,7 +4,7 @@ import styled from 'react-emotion'; import { List, Map } from 'immutable'; import ImmutablePropTypes from 'react-immutable-proptypes'; import Frame from 'react-frame-component'; -import { lengths } from 'netlify-cms-ui-default'; +import { lengths, colors } from 'netlify-cms-ui-default'; import { resolveWidget, getPreviewTemplate, getPreviewStyles } from 'Lib/registry'; import { ErrorBoundary } from 'UI'; import { selectTemplateName, selectInferedField } from 'Reducers/collections'; @@ -12,7 +12,11 @@ import { INFERABLE_FIELDS } from 'Constants/fieldInference'; import EditorPreviewContent from './EditorPreviewContent.js'; import PreviewHOC from './PreviewHOC'; import EditorPreview from './EditorPreview'; -import { TYPES_KEY, resolveFunctionForMixedField } from 'netlify-cms-lib-util'; +import { + TYPES_KEY, + resolveFunctionForTypedField, + getErrorMessageForTypedFieldAndValue, +} from 'netlify-cms-lib-util'; const PreviewPaneFrame = styled(Frame)` width: 100%; @@ -74,12 +78,12 @@ export default class PreviewPane extends React.Component { // custom preview templates, where the field object can't be passed in. let field = fields && fields.find(f => f.get('name') === name); let value = values && values.get(field.get('name')); - let mixedWidgets = field.get(TYPES_KEY); + let types = field.get(TYPES_KEY); let nestedFields = field.get('fields'); let singleField = field.get('field'); - if (mixedWidgets) { - field = field.set(TYPES_KEY, this.getMixedWidgets(field, value)); + if (types) { + field = field.set(TYPES_KEY, this.getTypedWidgets(field, value)); } if (nestedFields) { @@ -109,19 +113,30 @@ export default class PreviewPane extends React.Component { return value ? this.getWidget(field, value, this.props) : null; }; - getMixedWidgets = (field, values) => { - const mixedFieldResolver = resolveFunctionForMixedField(field); + getTypedWidgets = (field, values) => { + const typedFieldResolver = resolveFunctionForTypedField(field); if (!values) { return null; } else if (List.isList(values)) { return (
      {values.map((value, idx) => { - const field = mixedFieldResolver(value); - const fields = field.get('fields'); + const typedField = typedFieldResolver(value); + if (!typedField) { + const errorMessage = getErrorMessageForTypedFieldAndValue(field, value); + return ( +
    • + Item {idx + 1} {errorMessage} +
      • + ); + } + const fields = typedField.get('fields'); return (
    • - {`Item ${idx + 1} [${field.get('label', field.get('name'))}]:`}{' '} + {`Item ${idx + 1} [${typedField.get( + 'label', + typedField.get('name'), + )}]:`}{' '} {this.getNestedWidgets(fields, value)}
      • ); @@ -129,7 +144,7 @@ export default class PreviewPane extends React.Component {
    ); } else { - const fields = mixedFieldResolver(values).get('fields'); + const fields = typedFieldResolver(values).get('fields'); return this.getNestedWidgets(fields, values); } }; @@ -191,15 +206,16 @@ export default class PreviewPane extends React.Component { widgetsFor = name => { const { fields, entry } = this.props; const field = fields.find(f => f.get('name') === name); - const mixedWidgets = field && field.get(TYPES_KEY); - const mixedFieldResolver = mixedWidgets && resolveFunctionForMixedField(field); + const types = field && field.get(TYPES_KEY); + const typedFieldResolver = types && resolveFunctionForTypedField(field); const value = entry.getIn(['data', field.get('name')]); let nestedFields = field && field.get('fields'); if (List.isList(value)) { return value.map(val => { - if (mixedFieldResolver) { - nestedFields = mixedFieldResolver(val).get('fields'); + if (typedFieldResolver) { + const typedField = typedFieldResolver(val); + nestedFields = typedField ? typedField.get('fields') : null; } const widgets = nestedFields && @@ -213,8 +229,9 @@ export default class PreviewPane extends React.Component { }); } - if (mixedFieldResolver) { - nestedFields = mixedFieldResolver(value).get('fields'); + if (typedFieldResolver) { + const typedField = typedFieldResolver(value); + nestedFields = typedField ? typedField.get('fields') : null; } return Map({ diff --git a/packages/netlify-cms-lib-util/src/index.js b/packages/netlify-cms-lib-util/src/index.js index fde60d428520..3120f56acdd0 100644 --- a/packages/netlify-cms-lib-util/src/index.js +++ b/packages/netlify-cms-lib-util/src/index.js @@ -12,6 +12,7 @@ export { TYPE_KEY, DEFAULT_TYPE_KEY, getTypedFieldForValue, - resolveFunctionForMixedField, + resolveFunctionForTypedField, resolveFieldKeyType, -} from './mixedWidget'; + getErrorMessageForTypedFieldAndValue, +} from './typedList'; diff --git a/packages/netlify-cms-lib-util/src/mixedWidget.js b/packages/netlify-cms-lib-util/src/typedList.js similarity index 61% rename from packages/netlify-cms-lib-util/src/mixedWidget.js rename to packages/netlify-cms-lib-util/src/typedList.js index 414f8fc8bedc..b617a055096d 100644 --- a/packages/netlify-cms-lib-util/src/mixedWidget.js +++ b/packages/netlify-cms-lib-util/src/typedList.js @@ -9,7 +9,7 @@ export function getTypedFieldForValue(field, value) { return types.find(type => type.get('name') === valueType); } -export function resolveFunctionForMixedField(field) { +export function resolveFunctionForTypedField(field) { const typeKey = resolveFieldKeyType(field); const types = field.get(TYPES_KEY); return value => { @@ -21,3 +21,15 @@ export function resolveFunctionForMixedField(field) { export function resolveFieldKeyType(field) { return field.get(TYPE_KEY, DEFAULT_TYPE_KEY); } + +export function getErrorMessageForTypedFieldAndValue(field, value) { + const keyType = resolveFieldKeyType(field); + const type = value.get(keyType); + let errorMessage; + if (!type) { + errorMessage = `Error: item has no '${keyType}' property`; + } else { + errorMessage = `Error: item has illegal '${keyType}' property: '${type}'`; + } + return errorMessage; +} diff --git a/packages/netlify-cms-widget-list/src/ListControl.js b/packages/netlify-cms-widget-list/src/ListControl.js index 6ab47a06546e..d185356f34b4 100644 --- a/packages/netlify-cms-widget-list/src/ListControl.js +++ b/packages/netlify-cms-widget-list/src/ListControl.js @@ -6,7 +6,12 @@ import { List, Map } from 'immutable'; import { partial } from 'lodash'; import { SortableContainer, SortableElement, SortableHandle } from 'react-sortable-hoc'; import { ObjectControl } from 'netlify-cms-widget-object'; -import { TYPES_KEY, getTypedFieldForValue, resolveFieldKeyType } from 'netlify-cms-lib-util'; +import { + TYPES_KEY, + getTypedFieldForValue, + resolveFieldKeyType, + getErrorMessageForTypedFieldAndValue, +} from 'netlify-cms-lib-util'; import { ListItemTopBar, ObjectWidgetTopBar, @@ -30,6 +35,7 @@ const StyledListItemTopBar = styled(ListItemTopBar)` const NestedObjectLabel = styled.div` display: ${props => (props.collapsed ? 'block' : 'none')}; border-top: 0; + color: ${props => (props.error ? colors.errorText : 'inherit')}; background-color: ${colors.textFieldBorder}; padding: 13px; border-radius: 0 0 ${lengths.borderRadius} ${lengths.borderRadius}; @@ -250,6 +256,9 @@ export default class ListControl extends React.Component { if (this.getValueType() === valueTypes.MIXED) { field = getTypedFieldForValue(field, item); + if (!field) { + return this.renderErroneousTypedItem(index, item); + } } return ( @@ -278,6 +287,27 @@ export default class ListControl extends React.Component { ); }; + renderErroneousTypedItem(index, item) { + const field = this.props.field; + const errorMessage = getErrorMessageForTypedFieldAndValue(field, item); + return ( + + + + {errorMessage} + + + ); + } + renderListControl() { const { value, forID, field, classNameWrapper } = this.props; const { itemsCollapsed } = this.state; From abff3b822157472b0dcc73d08c143e5b06f37e8e Mon Sep 17 00:00:00 2001 From: smnh Date: Sun, 2 Dec 2018 13:16:00 +0200 Subject: [PATCH 5/8] Typed list changes - removed utils from netlify-cms-lib-util - removed changes to EditorPreviewPane.js - replaced select with button with dropdown list --- .../EditorPreviewPane/EditorPreviewPane.js | 119 +++--------------- packages/netlify-cms-lib-util/src/index.js | 9 -- .../src/ObjectWidgetTopBar.js | 81 +++++------- .../src/ListControl.js | 19 +-- .../src/typedListHelpers.js} | 0 .../src/ObjectPreview.js | 3 +- 6 files changed, 60 insertions(+), 171 deletions(-) rename packages/{netlify-cms-lib-util/src/typedList.js => netlify-cms-widget-list/src/typedListHelpers.js} (100%) diff --git a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js index ca98c262d1ca..a439db9ae330 100644 --- a/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js +++ b/packages/netlify-cms-core/src/components/Editor/EditorPreviewPane/EditorPreviewPane.js @@ -4,7 +4,7 @@ import styled from 'react-emotion'; import { List, Map } from 'immutable'; import ImmutablePropTypes from 'react-immutable-proptypes'; import Frame from 'react-frame-component'; -import { lengths, colors } from 'netlify-cms-ui-default'; +import { lengths } from 'netlify-cms-ui-default'; import { resolveWidget, getPreviewTemplate, getPreviewStyles } from 'Lib/registry'; import { ErrorBoundary } from 'UI'; import { selectTemplateName, selectInferedField } from 'Reducers/collections'; @@ -12,11 +12,6 @@ import { INFERABLE_FIELDS } from 'Constants/fieldInference'; import EditorPreviewContent from './EditorPreviewContent.js'; import PreviewHOC from './PreviewHOC'; import EditorPreview from './EditorPreview'; -import { - TYPES_KEY, - resolveFunctionForTypedField, - getErrorMessageForTypedFieldAndValue, -} from 'netlify-cms-lib-util'; const PreviewPaneFrame = styled(Frame)` width: 100%; @@ -26,11 +21,6 @@ const PreviewPaneFrame = styled(Frame)` border-radius: ${lengths.borderRadius}; `; -const nestedListStyle = { - marginTop: 0, - paddingLeft: '2em', -}; - export default class PreviewPane extends React.Component { getWidget = (field, value, props, idx = null) => { const { fieldsMetaData, getAsset, entry } = props; @@ -78,14 +68,9 @@ export default class PreviewPane extends React.Component { // custom preview templates, where the field object can't be passed in. let field = fields && fields.find(f => f.get('name') === name); let value = values && values.get(field.get('name')); - let types = field.get(TYPES_KEY); let nestedFields = field.get('fields'); let singleField = field.get('field'); - if (types) { - field = field.set(TYPES_KEY, this.getTypedWidgets(field, value)); - } - if (nestedFields) { field = field.set('fields', this.getNestedWidgets(nestedFields, value)); } @@ -97,15 +82,14 @@ export default class PreviewPane extends React.Component { const labelledWidgets = ['string', 'text', 'number']; if (Object.keys(this.inferedFields).indexOf(name) !== -1) { value = this.inferedFields[name].defaultPreview(value); - } else if (labelledWidgets.indexOf(field.get('widget')) !== -1) { + } else if ( + value && + labelledWidgets.indexOf(field.get('widget')) !== -1 && + value.toString().length < 50 + ) { value = (
    - {field.get('label', field.get('name'))}:{' '} - {value && value.toString().length < 50 ? ( - value - ) : ( - {'undefined'} - )} + {field.get('label', field.get('name'))}: {value}
    ); } @@ -113,90 +97,32 @@ export default class PreviewPane extends React.Component { return value ? this.getWidget(field, value, this.props) : null; }; - getTypedWidgets = (field, values) => { - const typedFieldResolver = resolveFunctionForTypedField(field); - if (!values) { - return null; - } else if (List.isList(values)) { - return ( -
      - {values.map((value, idx) => { - const typedField = typedFieldResolver(value); - if (!typedField) { - const errorMessage = getErrorMessageForTypedFieldAndValue(field, value); - return ( -
    • - Item {idx + 1} {errorMessage} -
      • - ); - } - const fields = typedField.get('fields'); - return ( -
    • - {`Item ${idx + 1} [${typedField.get( - 'label', - typedField.get('name'), - )}]:`}{' '} - {this.getNestedWidgets(fields, value)} -
      • - ); - })} -
    - ); - } else { - const fields = typedFieldResolver(values).get('fields'); - return this.getNestedWidgets(fields, values); - } - }; - /** * Retrieves widgets for nested fields (children of object/list fields) */ getNestedWidgets = (fields, values) => { // Fields nested within a list field will be paired with a List of value Maps. if (List.isList(values)) { - return ( -
      - {values.map((value, idx) => ( -
    • - Item {idx + 1}: {this.widgetsForNestedFields(fields, value)} -
      • - ))} -
    - ); + return values.map(value => this.widgetsForNestedFields(fields, value)); } // Fields nested within an object field will be paired with a single Map of values. return this.widgetsForNestedFields(fields, values); }; - /** - * Use widgetFor as a mapping function for recursive widget retrieval - */ - widgetsForNestedFields = (fields, values) => { - return ( -
      - {fields.map((field, idx) => ( -
    • {this.widgetFor(field.get('name'), fields, values)}
      • - ))} -
    - ); - }; - getSingleNested = (field, values) => { if (List.isList(values)) { - return ( -
      - {values.map((value, idx) => ( -
    • - Item {idx + 1}: {this.getWidget(field, value, this.props, idx)} -
      • - ))} -
    - ); + return values.map((value, idx) => this.getWidget(field, value, this.props, idx)); } return this.getWidget(field, values, this.props); }; + /** + * Use widgetFor as a mapping function for recursive widget retrieval + */ + widgetsForNestedFields = (fields, values) => { + return fields.map(field => this.widgetFor(field.get('name'), fields, values)); + }; + /** * This function exists entirely to expose nested widgets for object and list * fields to custom preview templates. @@ -206,17 +132,11 @@ export default class PreviewPane extends React.Component { widgetsFor = name => { const { fields, entry } = this.props; const field = fields.find(f => f.get('name') === name); - const types = field && field.get(TYPES_KEY); - const typedFieldResolver = types && resolveFunctionForTypedField(field); + const nestedFields = field && field.get('fields'); const value = entry.getIn(['data', field.get('name')]); - let nestedFields = field && field.get('fields'); if (List.isList(value)) { return value.map(val => { - if (typedFieldResolver) { - const typedField = typedFieldResolver(val); - nestedFields = typedField ? typedField.get('fields') : null; - } const widgets = nestedFields && Map( @@ -229,11 +149,6 @@ export default class PreviewPane extends React.Component { }); } - if (typedFieldResolver) { - const typedField = typedFieldResolver(value); - nestedFields = typedField ? typedField.get('fields') : null; - } - return Map({ data: value, widgets: diff --git a/packages/netlify-cms-lib-util/src/index.js b/packages/netlify-cms-lib-util/src/index.js index 3120f56acdd0..3654ab761d5c 100644 --- a/packages/netlify-cms-lib-util/src/index.js +++ b/packages/netlify-cms-lib-util/src/index.js @@ -7,12 +7,3 @@ export { filterPromises, resolvePromiseProperties, then } from './promise'; export unsentRequest from './unsentRequest'; export { filterByPropExtension, parseResponse, responseParser } from './backendUtil'; export loadScript from './loadScript'; -export { - TYPES_KEY, - TYPE_KEY, - DEFAULT_TYPE_KEY, - getTypedFieldForValue, - resolveFunctionForTypedField, - resolveFieldKeyType, - getErrorMessageForTypedFieldAndValue, -} from './typedList'; diff --git a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js index 06eef4ffc924..b0564f170ea3 100644 --- a/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js +++ b/packages/netlify-cms-ui-default/src/ObjectWidgetTopBar.js @@ -3,6 +3,7 @@ import PropTypes from 'prop-types'; import styled, { css } from 'react-emotion'; import Icon from './Icon'; import { colors, buttons } from './styles'; +import Dropdown, { StyledDropdownButton, DropdownItem } from './Dropdown'; import ImmutablePropTypes from 'react-immutable-proptypes'; const TopBarContainer = styled.div` @@ -52,75 +53,53 @@ const AddButton = styled.button` } `; -const AddItem = styled.div` - display: flex; - justify-content: center; - align-items: center; -`; - class ObjectWidgetTopBar extends React.Component { static propTypes = { allowAdd: PropTypes.bool, types: ImmutablePropTypes.list, onAdd: PropTypes.func, + onAddType: PropTypes.func, onCollapseToggle: PropTypes.func, collapsed: PropTypes.bool, heading: PropTypes.node, label: PropTypes.string, }; - constructor(props) { - super(props); - - let type = null; + renderAddUI() { + if (!this.props.allowAdd) { + return null; + } if (this.props.types && this.props.types.size > 0) { - type = this.props.types.get(0).get('name'); + return this.renderTypesDropdown(this.props.types); + } else { + return this.renderAddButton(); } - - this.state = { - type: type, - }; } - handleWidgetChange = event => { - this.setState({ type: event.target.value }); - }; - - handleAdd = e => { - this.props.onAdd(e, this.state.type); - }; + renderTypesDropdown(types) { + return ( + ( + Add {this.props.label} item + )} + > + {types.map((type, idx) => ( + this.props.onAddType(type.get('name'))} + /> + ))} + + ); + } - addItemUI() { - if (!this.props.allowAdd) { - return null; - } - const types = this.props.types; - const addButton = ( - + renderAddButton() { + return ( + Add {this.props.label} ); - - if (types && types.size > 0) { - return ( - - - {addButton} - - ); - } else { - return addButton; - } } render() { @@ -134,7 +113,7 @@ class ObjectWidgetTopBar extends React.Component { {heading} - {this.addItemUI()} + {this.renderAddUI()}     ); } diff --git a/packages/netlify-cms-widget-list/src/ListControl.js b/packages/netlify-cms-widget-list/src/ListControl.js index d185356f34b4..cb1cc4c899b7 100644 --- a/packages/netlify-cms-widget-list/src/ListControl.js +++ b/packages/netlify-cms-widget-list/src/ListControl.js @@ -11,7 +11,7 @@ import { getTypedFieldForValue, resolveFieldKeyType, getErrorMessageForTypedFieldAndValue, -} from 'netlify-cms-lib-util'; +} from './typedListHelpers'; import { ListItemTopBar, ObjectWidgetTopBar, @@ -153,13 +153,17 @@ export default class ListControl extends React.Component { this.props.setInactiveStyle(); }; - handleAdd = (e, type, typeKey) => { + handleAdd = e => { e.preventDefault(); const { value, onChange } = this.props; - let parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); - if (this.getValueType() === valueTypes.MIXED && type) { - parsedValue = parsedValue.set(typeKey, type); - } + const parsedValue = this.getValueType() === valueTypes.SINGLE ? null : Map(); + this.setState({ itemsCollapsed: this.state.itemsCollapsed.push(false) }); + onChange((value || List()).push(parsedValue)); + }; + + handleAddType = (type, typeKey) => { + const { value, onChange } = this.props; + let parsedValue = Map().set(typeKey, type); this.setState({ itemsCollapsed: this.state.itemsCollapsed.push(false) }); onChange((value || List()).push(parsedValue)); }; @@ -320,8 +324,9 @@ export default class ListControl extends React.Component {
    this.handleAdd(e, type, resolveFieldKeyType(field))} + onAddType={type => this.handleAddType(type, resolveFieldKeyType(field))} heading={`${items.size} ${listLabel}`} label={labelSingular.toLowerCase()} onCollapseToggle={this.handleCollapseAllToggle} diff --git a/packages/netlify-cms-lib-util/src/typedList.js b/packages/netlify-cms-widget-list/src/typedListHelpers.js similarity index 100% rename from packages/netlify-cms-lib-util/src/typedList.js rename to packages/netlify-cms-widget-list/src/typedListHelpers.js diff --git a/packages/netlify-cms-widget-object/src/ObjectPreview.js b/packages/netlify-cms-widget-object/src/ObjectPreview.js index 545a55014a7d..1ae7788ede6d 100644 --- a/packages/netlify-cms-widget-object/src/ObjectPreview.js +++ b/packages/netlify-cms-widget-object/src/ObjectPreview.js @@ -1,12 +1,11 @@ import React from 'react'; import PropTypes from 'prop-types'; import { WidgetPreviewContainer } from 'netlify-cms-ui-default'; -import { TYPES_KEY } from 'netlify-cms-lib-util'; const ObjectPreview = ({ field }) => (
    {field.get('label', field.get('name'))}
    - {(field && (field.get(TYPES_KEY) || field.get('fields') || field.get('field'))) || null} + {(field && (field.get('types') || field.get('fields') || field.get('field'))) || null}     ); From 885881f7a87bb623dc8043b9312ee848254d38ec Mon Sep 17 00:00:00 2001 From: smnh Date: Thu, 13 Dec 2018 12:50:06 +0200 Subject: [PATCH 6/8] rolled back changes to ObjectPreview.js --- packages/netlify-cms-widget-object/src/ObjectPreview.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/packages/netlify-cms-widget-object/src/ObjectPreview.js b/packages/netlify-cms-widget-object/src/ObjectPreview.js index 1ae7788ede6d..605c3f558d5c 100644 --- a/packages/netlify-cms-widget-object/src/ObjectPreview.js +++ b/packages/netlify-cms-widget-object/src/ObjectPreview.js @@ -4,8 +4,7 @@ import { WidgetPreviewContainer } from 'netlify-cms-ui-default'; const ObjectPreview = ({ field }) => ( -
    {field.get('label', field.get('name'))}
    - {(field && (field.get('types') || field.get('fields') || field.get('field'))) || null} + {(field && field.get('fields')) || field.get('field') || null}     ); From 4d945b06986750ac28b6a02c12afb2496a956336 Mon Sep 17 00:00:00 2001 From: smnh Date: Thu, 20 Dec 2018 16:34:20 +0200 Subject: [PATCH 7/8] updated list widget doc to clearify that typed list can only include items of object type --- website/content/docs/widgets/list.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/content/docs/widgets/list.md b/website/content/docs/widgets/list.md index 28c26c4e0671..a8f5e60cb0a1 100644 --- a/website/content/docs/widgets/list.md +++ b/website/content/docs/widgets/list.md @@ -3,7 +3,7 @@ label: "List" title: list --- -The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list with different widget types. +The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list of different object widgets. - **Name:** `list` - **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values. If `types` is specified instead, the list will render items of different widget types. @@ -13,8 +13,8 @@ The list widget allows you to create a repeatable item in the UI which saves as - `allow_add`: if added and labeled `false`, button to add additional widgets disappears. When used together with `types`, additional control for selecting a widget type will be available. - `field`: a single widget field to be repeated - `fields`: a nested list of multiple widget fields to be included in each repeatable iteration - - `types`: a nested list of widgets. Each widget will define different item type that could be added to the list. - - `typeKey`: the name of the field that will be added to every item in list representing the name of the widget type that item belongs to. Ignored if `types` is not defined. Default is `type`. + - `types`: a nested list of object widgets. All widgets must be of type `object`. Every object widget may define different set of fields. + - `typeKey`: the name of the field that will be added to every item in list representing the name of the object widget that item belongs to. Ignored if `types` is not defined. Default is `type`. - **Example** (`field`/`fields` not specified): ```yaml - label: "Tags" @@ -98,4 +98,4 @@ The list widget allows you to create a repeatable item in the UI which saves as - images/image05.png - images/image06.png ``` - The `type` field must be present on each section object and will be added automatically when new section is created through CMS. To use different name for this field, set the `typeKey`. + The `type` field must be present on every item in the list. It will be added automatically when new item is created through CMS. To use different name for this field, use `typeKey` option. From 3ed0efe84c2c19255f7ded6e4ec5d0a0103356bf Mon Sep 17 00:00:00 2001 From: Shawn Erquhart Date: Wed, 26 Dec 2018 23:41:49 -0500 Subject: [PATCH 8/8] move docs to beta features section --- website/content/docs/beta-features.md | 78 +++++++++++++++++++++++++++ website/content/docs/widgets/list.md | 56 ++----------------- 2 files changed, 81 insertions(+), 53 deletions(-) diff --git a/website/content/docs/beta-features.md b/website/content/docs/beta-features.md index e19932b75f40..46c85c193872 100644 --- a/website/content/docs/beta-features.md +++ b/website/content/docs/beta-features.md @@ -8,6 +8,84 @@ We run new functionality in an open beta format from time to time. That means th **Use these features at your own risk.** +## List Widget: Variable Types +Before this feature, the [list widget](/docs/widgets/#list) allowed a set of fields to be repeated, but every list item had the same set of fields available. With variable types, multiple named sets of fields can be defined, which opens the door to highly flexible content authoring (even page building) in Netlify CMS. + +**Note: this feature does not yet support previews, and will not output anything in the preview +pane.** + +To use variable types in the list widget, update your field configuration as follows: + +1. Instead of defining your list fields under `fields` or `field`, define them under `types`. Similar to `fields`, `types` must be an array of field definition objects. +2. Each field definition under `types` must use the `object` widget (this is the default value for +`widget`). + +### Additional list widget options + +- `types`: a nested list of object widgets. All widgets must be of type `object`. Every object widget may define different set of fields. +- `typeKey`: the name of the field that will be added to every item in list representing the name of the object widget that item belongs to. Ignored if `types` is not defined. Default is `type`. + +### Example Configuration + +The example configuration below imagines a scenario where the editor can add two "types" of content, +either a "carousel" or a "spotlight". Each type has a unique name and set of fields. + +```yaml +- label: "Home Section" + name: "sections" + widget: "list" + types: + - label: "Carousel" + name: "carousel" + widget: object + fields: + - {label: Header, name: header, widget: string, default: "Image Gallery"} + - {label: Template, name: template, widget: string, default: "carousel.html"} + - label: Images + name: images + widget: list + field: {label: Image, name: image, widget: image} + - label: "Spotlight" + name: "spotlight" + widget: object + fields: + - {label: Header, name: header, widget: string, default: "Spotlight"} + - {label: Template, name: template, widget: string, default: "spotlight.html"} + - {label: Text, name: text, widget: text, default: "Hello World"} +``` + +### Example Output + +The output for the list widget will be an array of objects, and each object will have a `type` key +with the name of the type used for the list item. The `type` key name can be customized via the +`typeKey` property in the list configuration. + +If the above example configuration were used to create a carousel, a spotlight, and another +carousel, the output could look like this: + +```yaml +title: Home +sections: + - type: carousel + header: Image Gallery + template: carousel.html + images: + - images/image01.png + - images/image02.png + - images/image03.png + - type: spotlight + header: Spotlight + template: spotlight.html + text: Hello World + - type: carousel + header: Image Gallery + template: carousel.html + images: + - images/image04.png + - images/image05.png + - images/image06.png +``` + ## Custom Mount Element Netlify CMS always creates its own DOM element for mounting the application, which means it always takes over the entire page, and is generally inflexible if you're trying to do something creative, like injecting it into a shared context. diff --git a/website/content/docs/widgets/list.md b/website/content/docs/widgets/list.md index a8f5e60cb0a1..f0cf2398a0be 100644 --- a/website/content/docs/widgets/list.md +++ b/website/content/docs/widgets/list.md @@ -3,18 +3,16 @@ label: "List" title: list --- -The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. Or you can define a list of different object widgets. +The list widget allows you to create a repeatable item in the UI which saves as a list of widget values. map a user-provided string with a comma delimiter into a list. You can choose any widget as a child of a list widget—even other lists. - **Name:** `list` -- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values. If `types` is specified instead, the list will render items of different widget types. +- **UI:** if `fields` is specified, field containing a repeatable child widget, with controls for adding, deleting, and re-ordering the repeated widgets; if unspecified, a text input for entering comma-separated values - **Data type:** list of widget values - **Options:** - `default`: if `fields` is specified, declare defaults on the child widgets; if not, you may specify a list of strings to populate the text field - - `allow_add`: if added and labeled `false`, button to add additional widgets disappears. When used together with `types`, additional control for selecting a widget type will be available. + - `allow_add`: if added and labeled `false`, button to add additional widgets disappears - `field`: a single widget field to be repeated - `fields`: a nested list of multiple widget fields to be included in each repeatable iteration - - `types`: a nested list of object widgets. All widgets must be of type `object`. Every object widget may define different set of fields. - - `typeKey`: the name of the field that will be added to every item in list representing the name of the object widget that item belongs to. Ignored if `types` is not defined. Default is `type`. - **Example** (`field`/`fields` not specified): ```yaml - label: "Tags" @@ -51,51 +49,3 @@ The list widget allows you to create a repeatable item in the UI which saves as - {label: Name, name: name, widget: string, default: "Emmet"} - {label: Avatar, name: avatar, widget: image, default: "/img/emmet.jpg"} ``` -- **Example** (with `types`): - ```yaml - - label: "Home Section" - name: "sections" - widget: "list" - types: - - label: "Carousel" - name: "carousel" - widget: object - fields: - - {label: Header, name: header, widget: string, default: "Image Gallery"} - - {label: Template, name: template, widget: string, default: "carousel.html"} - - label: Images - name: images - widget: list - field: {label: Image, name: image, widget: image} - - label: "Spotlight" - name: "spotlight" - widget: object - fields: - - {label: Header, name: header, widget: string, default: "Spotlight"} - - {label: Template, name: template, widget: string, default: "spotlight.html"} - - {label: Text, name: text, widget: text, default: "Hello World"} - ``` - Above list widget may be used to create following frontmatter with two carousel and one spotlight sections: - ```yaml - title: Home - sections: - - type: carousel - header: Image Gallery - template: carousel.html - images: - - images/image01.png - - images/image02.png - - images/image03.png - - type: spotlight - header: Spotlight - template: spotlight.html - text: Hello World - - type: carousel - header: Image Gallery - template: carousel.html - images: - - images/image04.png - - images/image05.png - - images/image06.png - ``` - The `type` field must be present on every item in the list. It will be added automatically when new item is created through CMS. To use different name for this field, use `typeKey` option.